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Visual Java Development 


Build Rome in a day. 

It's easy with Symantec 
Visual Cafe' for Java: 





Develop faster Compile 
faster Debug Faster. Realize 
your Java"^ dreams faster. 

Symantec, the crBator of 
the first full-featured Java 
development environment, now unleashes 
the first Rapid Application Development 
environment for Java developers: 

Symantec Visual Cafer' 



Visual Cafe comes complete with an 
extensible component library with all of the 
building blocks you need for your application. 

Simply drag and drap a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Cafe 
automatically generates the Java 
code for you. 

Thanks to our exclusive hvo-way 
programming you can add or modify 
the code at the source level, too. 

So youll be vvhipping out those 
application prototypes at speeds 
you can only dream of now. 

Imagine building all of your forms 
visually. Or building your entire user interface 
without writing one single line of code! 

As an added bonus. Symantec's Just In 
Time (JIT) compiler (included in Netscape's 
new Navigator’") runs your Java applications 
faster than any other browser or Java 
virtual machine on the planet. 

So get your hands on the hottest new 
development tool for Java right away. 

For more information, call us at 
1^800*453-1059 ext. 9H29 or visit our 
Web site at cafe.symantec.com. Or 
pick up a copy at Fry's, MicroCentar, 
CompUSA or Egghead. 
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Eddy Award Winner for Best New DeveUiper Ttml 

- MacUser Editors Choice Aivards, 1993 

’■tif 

distihct improvement over ResEdil” 

- MaeTech IMacTuLor 

"^Resorcerer^s data template system is amaziiigr 
-Bill Goodman, author of Compact Pro 

^Nuke ResEdit! Resorcerer is mission-critical for us.*" 

— Dave Winer^ IJserland Frontier 

‘^The color pixel exlitorH are wonderful! A work of artP 
— Dave Winzler, author of Microseeds Redux 

"^Euery Macintosh developer should own a copy of RcBorcerer. ” 

- Leonard Rosenihof Aladdin Systems 

"^Resorcerer will pay for itself many times over in saved time and effort 

- MacUser review 

**The template that disassemhles PJCT's is awesomer 

- Bill Steinberg, author ofPyro! and PBTimls 

*"Resoreerer proirnl indispensible in Us own creationr 
-Doug McKenna, author of Resorcerer 

wealth of time-saving tools.'' 

McicUser Review^ Dec. 1992 


Resorcerer* 


Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


0 R D E R!N Q INFO 


Needs: >Mac Plus, ^ Sys 4.2, 1MB 
Likes: >Mac Plus, > Sys 7.0, 2MB 
32-bit clean, AU/5C compatible 

Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 

Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Payment: Check, PO's, or Visa/MC 

Extras (call us): 

COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: 

AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tools 
or call us. 


• New ‘cicn’, ^pat\ ‘ersr^ ‘acur\ *pltt\ ^cluP editors 
■ Powerful icon family editing (all 9 icon types) 

• Color pixel anti-aliasing, dithering, and lots more 

• Complete ‘PICT' disassembly and reassembly 
New 1.2 Features: • Resource sorting; ROM resource browsing 

• 120 template field parsing types now supported 

• New insertion & deletion template field types 

• Text-only ^PICT' resources 

• Lots of improvements throughout 

• Easier, faster, more Mac-like, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 
» Builds resource files from simple Rez-like scripts 

• Most editors DeRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre^ and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Help, AppIeEvent, OCE, GX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, 'ietb^s, lists and popups, oven create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 
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By Erie Gundnim 


Have You Put Yolir Development on Hold? 

Do you have your development projects on hold while you 
wait for more itifonnation about Rhapsody? I sure hope not. 
Historically, Apple has had a tendency to tell devek>[x:rs about 
ilieir grandiose lecrhnology plans and warn developers a%vay 
from pursuing their own dreams because the “stjon to be 
released** Apple technology will make obsolete those of the 
developer. Then, often enough, Apple’s technology doesn’t 
arrive until years later, if at alL 

I don’t mean to say ikit Rhapsody won’t arrive, or even will 
be late. Apple has an ambitious development schedule, but they 
have dn>pixxi alnuxsl everydiing el.se to fextis exclusively on the 
release of Rhapscxly. This is pnobabiy a gtxxl thing given how 
Apple’s futuie rides almost exclusively on the success of Rhapsody. 

However, Apple's technology marketing has typically been 
about two years ahead of the lcchnolt>gie.s, llial is, Apple 
convinces developers to adopt the new technologies a year in 
two UK) soon* This often leaves the developer stRiggling to meet 
cash flow requirements while Apple Hxes bugs and the market 
evaluates the technology. 

Apple’s Official OS Schedule 

Lei*s look at the Rha|xsody schedule for a moment. 
Sometime this summer Apple will release to devclt)fK*rs the rirst 
develo(KT version of the new OS, but it likely will not be much 
more than NliXTS'rEP on Pow^tPC. Early in 199R Apple will offer 
the Premier Release of idiapscxiy to all who want it. Tliis release 
Ls ex[XTted to include all ifie planned features of the new OS, 
including a new Macintosh Itxjk and feel* but it will have only 
limited suppon for MacOS-hased apj^licaiions (the coitipaitbiliiy 
lx)x). Lite in 1998 A()ple promises to release the Unified version 
of Uhapscxly. ITiis is supposed to l)c the finished produd, and is 
likely to be the first version of Rhapsody to ship with hanJware. 
This is the first versitjn iniended to replace the MacOS. 

Over that same eighteen nionihs Afiple wall release iwo 
major MacOS upgmdes. These versions are intended to integrate 
the Ixst of A[)f)le’s existing technologies and clear the shelves o{ 
anything interesting Aj^jj^le had [ilanned and was reasonably ftir 
along for Copland. We all expect die first sucli relea*se. Tempo, 
will include a threaded Finder with the Copland kM>k and feci. 
I'm not sure whai to exfxrcl from the later relea.se. If we are 
lucky, we will also eventually see V-Twin and Mela Content 
Framework (MCF-HotSauce). I'he.se same technologies arc^ 
planned to lx rolled into the Rhaps(xly compatibility box by the 
Unified release, Iliese are the versions of the OS Apple will .sliip 
widi hardware, at least umil the Unified Rhapsody is available. 


Yes Officer, Ell Slow Down 

* Over liie years 1 have seen a great many Macintosh 
developers get excited al>out new Apple tedirn>logies at least a 
year too stx)n for them to make a living from tire new 
technologies. Now may be the time for us to slow down a little 
and look at the OS we are living wiili right now. We have many 
great ret hnologies that will be with us for many years to come. 
Maylx' we should ftxajs on those technologies a bit longer while 
we evaluate our ideas for Rliafxsody. 

When the developer version of RhapstxJy is reloiscd later 
this summer will be a good time for us developers to take a kx)k 
and see what is possible witli llie new, jmxlern OS* It is quite 
likely there will be countless l>its of software rdcascxl to tJie 
community within days and weeks of the developer release, but 
most of thui Ls just our exploring the technology. 'Ihe real market 
won’t even begin to develo[> until several months after the 
I’remiere rele^J5e, and that is plenty ol’ time to learn the new OS 
and develop some ccx)l software for It. Let's be patient and make 
.sure we continue to put bread on our la hie by satisfying the 
market already at our doorstep. 

Tu liclp you prepare for Khupsocly, MacTech will 
continue to bring you coverage of as much Rhapsody 
technology as we can gel out of A[)ple. You can also find very 
u.seful descTiprions and tutorials on the NeXT technologies 
from NeXT's web site at <http://wvwv.next.eom/>. 

To help you take advantage of Macintosh technologies 
already avaliable and soon to be released, we will also 
include coverage of them, including Cyber Dog, (D pen Doc, 
Game Sprockets, Speech, OpenTrauspoil, V-Twin and MCF* 
Although Apple has stated these teehnologies are not dead, 
just in maintenance mode, maybe some cool applications of 
these technologie.s will convince Ap])le t)r the marketing need 
to port them to Rhapsody. They are compelling technologie.s, 
and it is Apple’s development of compelling technologies, 
and our desire for them, that has kept Apple alive all these 
years* Let's not ignore them. 

MacHack on hie Horizon 

Many developers are lcx>king for ways lo qtiickly Icani alxjut 
Rhap,s<x]y. One of the best wiia'es is likely to lx* June’s MacHack. 
If Apple keeps to their 08 schedule, there is a gcxxl chance the 
MacHack crew will have Rhapsexly DKl nmning in the Machine 
Room anti several Apple engineers making piesentafions and 
looking for people to write c<h)! hacks. Think of it as a huge 
coding kitchen. Check out <http://www.machack*a)m/> ft)r more 
inft)rmafion about MacHack, Ki 
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MacHASP Packs 
More Into Less. 

Based on state-of-the-art ASIC technology, 
MaclIASP packiJ the indiisiry's mosl 
advana'd scciirit); compatibility iutd 
flexibility into a compact and ciid-iiser- 
Incndly dongle. 

Grow With Aladdin! 

’Ilie fastest growing company 
in the industry, with over 4 
million keys sold to 20 
thousand developers 
worldwide, Aladdin is setting 
llie standard for software security today. 



McmHASP 
PROTECTS 
MORE. 


NSTL Study Rates 
HASPIio.1! 

A recent test conducted by tlie Nsaional 
Software Testing Ubs', llie world’s foreimst 
independent lab, coinjiared tlie flagship PC 
products of leading software protection 
vendoR. Tlie result? HASP was rated tlie clear 
overall winner - and numlier one in all the 
major coinparisun CiUegories. For a full copy 
of tlie NSTL rqjon, contact your local 
HASP distributor. 


MaCOS 

These days, more and more developers are choosing to protect their software against 
piracy. They're protecting more products, on more platforms, with better protection - 
and selling more as a result. 

And more of thest; developers are protecting with .MacHASP. Why? 

Because MacHASP offers more security, more reliability juid more 
features than any oilier product on tlte market. Only MacHASP offers 
capabilities such as network support, anti-debugging envelope 
protection, and secure remote activation and updating. 

MacHASP supports the most advanced platforms, including all 
veniions of MacOS and Power Mac - as wel I as AppleTalk 
networks. And because Aladdin is a liccascd Apple Partner, ' 

MacHASP guarantees full, transparent compatibility 
with the ADR standard. 

To learn more about how you can protect 
better - and sell more - call now to order 
your MacHASP Uevelo|)er‘s Kit. 



/be Mac/m' /kt’ch^KT’s /& conUtiiis 

mt nml/o proiec^ wnr 


1 - 800 - 223-4277 

www.aks.coiii 


North America Aladdin Knowledge Sy^ems luc. Td, Wt 4277, 2U-%A I'ox: 2]2'S64 
IMI Office Aladdin Knowledge Systems Ltd. TH; +972-^^ 22H, taxi +972'M37 57%, K^mail 11 *^ 1 . 

Germany FAST Software Securtly AG Id: +4989 »9 42 21-37, Fas: +4989 4221K mait- iirfo«>»fast-aR,cfe 

UoEted Kingdom Aladdin Knowledge Systems UK Ltd. Td +-44 175.V^223%, Pm ’1 44 1753 K mail. sate#akln.oo.tik 
Japan Aladdin Japan Co., Lid. id +81 mMim, Faxr 1 hi 42* 7194, F naaiJ: !Cilts<?^4JaiJai[f.ci>.ip 

Benelux Aladdin Software Secortty Beneimt B.V. teP ^51 24441 9777, Hto; +3t 24445 1981, K-miUL 10052*. I Woompustm+aiin 

■ Aliddlfi fluxtu iDSft?:VKSaR AostrsHa Caiob CO MSSSCftSs CWc UEronqica rdfilXm ■ Otra Shtrgtia L»I1 tEil Allu 027GEOB5 ■ Ctanark me ^mi& R Einiit;(iM:ltlQri PZ 3EIH03? V ROlMil e p fnm t 'tWijSQBSa Cihh 

iMHvn Cil m Hoftf Kong Hnlino) 4? R Imlla SohRkm ITIT ■ Itatf Planner Dou 0? % 147300 ■ Kona Das 0 02 0404401 ■ Maxteo 99 I11B ■ Ninv Zealaod TraimiQ 04 5060014 m Fiolintl SnUKinn (%1 400773 ■ Parhigal FuttniuKo 01 41 

■ RMiuita RO PD4 140703 ■ Slnga^ta IIH mh msm m Sum Mika D Lt non 011 0064704 « Spain PC HwOwn 0.1 44P1I01 t SwtficrlHid Opag OGI 7imZ2 D Taiww 1na OZ R EurMy KUvmtHla S01S 4070033 R VUgmiiivia Axys 

Ch3ii»iwHD4W%liHaLjg lias 1101 itanMraMP^HiNvunixMtthntf^UiRInnviMHl^ AifMpraiintiiinijirptmnniiktiiilafniaacltfiMiai MiLiBallKOtlviaHiiiiDniiMtfkKtwpMa.lR.wniiwvinnt Rill wtwoKannMUitiirfr^tpamniRB^iiiRil itRilt^illni 


ALADDIN 


The Professional's Choice 









GETTING 

STARTED 

I 

by Dave Mark, ©1997, Ail Rights Reserved. hUp://unmv.spiderworks.com 



More Objective-C 


Lksi month, we took our first msic of 
Objective-C. We learned that Objective-C 
sources use the extension “.m" for imin 
source files and ".h" for Iieader hies. The 
type ''id" is used to declare a generic pointer 
which allows us to delay type binding 
decisions. We learned that mc^st objects are 
derivetl from the Root class Object. The 
Object class features variables and metlK)ds 
inherited by all other classes. One of these 
variables is which sjxx'ihes tlic class lo 
whit h an object belongs. 

We saw the form for a class interface: 

HyClass r HySuperClass 

[ 

itiiftitnce vairiablo decXaratiotiE 
I 

method declarations 
iend 


We also learned about Ohjective-C*s 
funky form of methexi declaration: 

- (lnt}getX: (int)x aridYi (intjyj 

Where the leading minus sign marks 
llte function as an insumce methcKl — as 
opj>o.sed to a which marks a methtxl 
as u class methexi, like a C++ static 
rnelhfxl. Ihe first '1nt" is the leturn ty|xr, 
and the otlier “int"s are the parameter 
types. The name of the metluxl above is 
""getXtandY:" 'Ihe default type Is id, so if 
you Ic^ave oul any of the types (including 
the return type) tlie type is ,set to id. 

We also learned alxmt the #im[x^rt 
compiler directive, used to avoid multiple 
inclusion of a .h llle: 

^import "'Oh|ect.h" 

Alternatively, you c:an avoid all the 
extra junk you get when you import a 
classes’ header file by using the ©class 


dinxtive to let the compiler know that a reference Ls to a legal class: 
ikiass Object: 

Innally, we saw the fonn used for die actual implementation 
of a class: 

^implementation HyCiass 
method definitions 
@end 


Mpssage Receivers and Message Sym ax 
Now it's on to new material. Once you declaie your class and 
use that declaration to define an object, it's time to bring that 
objea to life by sending it a message. In C++, you call an object’s 
memlxir function using the object itself to make the call: 

nyObjectPti: >MejnberFunetionf): 

In ObjeciiveC, a mess;ige is said to lx‘ sent It) a receiver 
using the following .syntax: 

[receiver ineasa&c] : 

The receiver Is an objea and the message Is a method, along 
w'iih its assexiated parameters. Tlie message is ,seni (and the 
appropriate method selected) at runtime. For exami)ie, supptxse 
die clasps named MyCia.ss included the following method: 

- {int)getX; t3nl)x aridlf: tint)y: 

Ju.st as a reminder, this method is called getX:andY:, takes 
two pammeters (Imlh of iliem inis), and returns an Int, Here's a 
line of code that sends a message asking a MyClass objea to 
pcrftrrm tlie geiX:andY: method: 

siyNuii = [myObj getX:27:50l; 

In thi.s erase, the object myObj (well see how to allocate an 
object in a .second), presumably of class MyClass, gets sent the 
getX;aodY: message, along with the parameters 27 and 50. 
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Mac, go out and touch the world for only 

ADB I/O lets youf ajslomes' Macs cootrot things^ it lets them fjegl. m 

I ADR l/n llm Mfir Hr rurt nF nhu^u^^^l uunrtH 


ADB I/O lels Uic Mac be part oF the physical woild 

Thousands of Uses 

Sdencc, Multimedia, Children's Museums, Hcxne Automation, 
Theatre Stages, Iridi^^lrial Testing, Medical Research, Bonsai 
Watering, Robotics, Weather Stations anything that can 
be eJectroricanv rneasured or controllcxi can use the /\D3 I/O. 

No Sortai Ports Octupiod 

ADB I/O uses the Apple Desktop Bus lo rximmunicate inputs and 
outputs to and from your Macintosh. (Maximum fitting frequency 
(s 90 Hz.) No external pow^ supply is needod. 

Eight I/O Channels Provided 

l-our netays tor output. Four channels for Dgilal Irv, 

Digital Out or S bit Analog In. 

Extensive Software Support 
With ADB I/O arxJ f>ear1v any environment,* 
it is easy to build ostomized 
applications for your control and 
data acquisition needs 
For more info, visit us at 
www.bzzzzzz.com. 


Auxkating AiN Object 

To allcxrale a new object, yoti’Ii send an alkx' tnes^sage to ilie 
clu.ss wIk>,sc object you want to create. Here's an example: 

U myObJ - [[KyClass allocl Itilth 

You'll use this line of code again and again, with a few 
alterations of course. We start off by defining an id to hold the 
reference to the allocated object. The right side of die 
operator is a message expression embedded in another method 
expression, much as you might embed a Function call inside a 
second function call (printf( “%d", GetMyValueQ); for example). 

In this case, we are first sending die ahoc message to 
MyClass. The alloc method is a factory method (it is declared 
with a leading 5ign instead of a leading ®-"), similar to a static 
member function in C++. It Ls inlicriicd from die Object class. 
Tlie alloc mediod allocates the memory for a single object of the 
specified class and returns a pointer to the objeci, 

Tiial ohjccT Ls dicn sent die init message, which causes that 
objea's init method to be performed. A classes' init method 
should return a pointer to the object (Dtherwi,se this code 
wouldn't work). The object pointer relumed by diLs nc'Sted pair 
of message expressions is assigned to the object pointer myObj. 


As you would expect, Objeedve-C has an analogy to the C++ 
keyword ""thisT To refer to the current object, use the term "selP. 
When you write your init meihotl (to initialize your newly 
alloc'ed oliject), you'll end it by returning seif: 

[■eiurn self: 

Oim First Objecitv’e-C Program 
Let’s bring all these concepts r.ogedter witli a simple example. 
Well create a Numl>cr class diat features a single variable, an int 
to hold tile Numlier’s current value. We’ll add methcxls for 
irdtializadon, one to square the Nuinhtrr’s current value, and one 
to print out die cuireni value. Wliile this example may seem trivial, 
it will act as a nice syntax reference as you build your own classes. 

By the time you read diis, Memjwerks sfiould liave delivered 
flielr first Objecilve-C tcxils (scheduled for release as part of May's 
CW12). Since I don't liave tliose tools in liand yet, 1 had to IcKik at 
alternative Objective-C environments. As 1 mentioned last mondi, 
Tenon makes a Mac cnvironmeni c'allcxl CodeBuilder which supports 
die gcc OirjcxTive-C compiler. CcxleUuilder supports an X environment 
c'alled AfterStep, along with a more cx^nventional imx teiminal 
environment running either C Shell, T-C Shell (an itntmrvcd C Shell), 
the tradidcrnal Ikxime Shell (less powerful, but uses less memory), 
and the Bourne Again Shell (bash^ Bourne Shell m&i improvemenLs). 
All this rides on top of a Berkeley 4.1BSI> unix system. 
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If you are into Unix, CodcButldt^r is definitely a lot of fun to 
play with. On the other hand, I find myself aching for the 
CodeWarrior IDE and editor to tie my projects togetlicr. Tfiough 
I must admit iliat I did enjoy using vi to edit all my source code. 
Amazingly, 1 remembered all tliose cryptic vi ci>mmands that 
made vi such a pleasure/pain to use. All, well, enough 
reminiscing — on to the axle,,, 

Ihe first thing I did was create a new folder to hold the 
source cfxle (if you are using CodeBuilder, die unjx cxjinmand 
“mkdir dirName'’ creates a new directory, "cd new dir" changes 
direaories, **mv oldname newnanie” changes file or directory 
names, *'rmdir dir" deletes an empty directory, '*vj filename" 
invokes the vi editor and ‘'man command" brings up an online 
manual for the specified conunand. If you are new to UNix or to 
vi, 1 would definitely try "man vf to get a sense of the editor 
before you get into it). 

Inside the new folder, 1 created three source files: Number.m, 
Number.h, and main.m. Here's the source for Numlx^cm: 

tfiraport "Number 
//^inciiKlc ‘NumberJi’ 

eimpleraentatlon Number 

- init: (intistiirtVtilvie 
[ 

[super inttj: 

value BtactValue: 

return selfl 
J 

squurcScUf 

( 

value *“ value; 

return self: 

I 

- print 
I 

prlfilft "Number value: %d\n", value ): 

return self: 

I 

dend 

*rhe release of CodeBuilder I had did not supptjil ^import (at 
least not in the usual fashion). If your envirtinment docs not 
support ^imjxin, commeni out that line and uncomment the 
^include. Remember, if you use ^include, you'll need to also make 
a con-es[>onding change to the header file {well get to it next). 

Number.m contains the implementation of the Number class. 
All three methods are instance metiiods and are dec:lared using 
the k'ading Notice that the inii method lakes a single 
parameter, staitValue, an int used to set the value of the instance 
variable named value. Value is declared in Numl>enh. 

The inif method starts off by sending an inil medaxl to ius 
superclass (in this case, the Object class). Doing this gives your 
superclass a chance to initialize its supercb.sses and itself, a real 
g(KKl idea. After setting value to siartValue, init returns a pointer 
to the newly initialized objeti (remember, self is like this in C++). 


squareSelf and print are fairly straightforward. Note that both 
remm self, though they don't necessarily need to, since their 
return value is ignored by main. Also, you can see dial the C 
standard library function printfO is available in Objective-C, As 
Rhapsody starts to kick in. I'll start making use of Mac interface 
calls instead of using console i/o but, for now, we need to make 
do witli what we have. 

Here's the source for Numlx:r.h: 

//rifndtrf _Numhcr3_ 

//#ddinc _Nmnber_h_ 

# imp o r t < obje/Ob J ec t, h > 
y/*include <obicyObjcct Ji> 

Sint erf ace Number : Object 

1 

int value; 

1 

i nit:(intjstartValue: 

squareSelf; 

print: 

@end 

//'ttklif 

Once again, if your environment tloesn't support ^^mporr, 
uncomment all the commented code above and comment out the 
srimport line. Note the declaration of the instance variable named 
value along with the declaration of the three methods init, 
squareSelf, and print Note tliai all three return an Id, since no 
return value is declared. That's why the: 

return self; 

at the end of each meihcxJ makes sense. 

Here's the source for main.m: 

^Include "Number.h“ 

void mainD 
[ 

id number HNtnnber alloci init:?7] ; 

[number print]; 

[number squareSelf]: 

[number print]; 

[number free]: 

I 

main() is jusi a sequence of method expressions. First, we 
declare number to be an objeci pointer, then we allocate and 
initialize a new Numlx:r object anti as.sign the object's pointer 
(returned by init) to numlier. Note tliat the value 27 was parsed 
in as a parameter to init. Got it? 

The rest of tlie program is cake. Send number the print message. 
Here's the line of output that appears in llte console window: 

Number value: 27 

Next, send number tfte squareSelf message. This cause.s the 
number object to square the value in value. Before you reach for 
your cakulalors, 27 * 27 = 729. Really. 
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'lb verify [hiN, we pxss another print mesiiage on to numiier 
Here's the line that appears in the console window: 

Number value: 729 

Finally, we send die free message to ntimber. Since die 
Number class does not override the Object classes' frc'e method, 
the Object classes' free method is tlic one that ends up getting 
called free. The Object version of free dealkK'aies all memory 
all(x.‘aLed for the object by alloc. Note that the Object version of 
free does not follow any pointers in your object to free any 
secondary memory. If you do allocate additional memory in yt>ur 
inlL method (don't override alloc), you'll want to override free 
and deallocate the additional memory. 

If you do override free, be sure to send the free message 
to super: 

[super freej; 

at the end of your free method to give super cla.sses a chance to 
clean up after themselves. 

By the way, if you arc using CodeBuilder, you might want 
to lake advantage of the lendc tool called Make. Create a file 
called Makefile in the same diret:tory as your sources, and type 
in these two lines: 

Number: main.m Number, m Number. h 

gcc ’0 Number maln.m Number-Inbjc 


Now you can recompile your program by just typing the 
command Make, 


Till Next Month.., 

1 am really enjoying the opponunity to mess with 
Objective-C, 'fhoiigh the syntax tlircw me at first, it didn't lake 
me long before T was thinking in it. This is not a hard language. 
Just a bit weird! I'm definitely looking forward to getting 
Rhapsody up and running on my macliine so I can experiment 
with true dynamic binding. Excellent! 

Just a heads up — I have gotten a lot of email asking me to 
update my How to Get Started Witli Mac Programming article. So 
much ha.s changed in tlie Mac universe (idiapsody, the Internet, 
Objcctive-C, Java, etc.) that the old rect^mmendaiions just don't 
hold water anymore. Within die next couple of months, I'm 
going to intermpi the Ol>jective-C series (just for one month!) to 
run a new version of that article. For ifuxse of you who are 
already way Mac programmers^ please l:Hsar witli me. Till then, 
it's back to iintx, vi, and Objective-C... B 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto;editorial@mactech.com> 


Q: What does it take to deploy a 
superior client/server application? 
A: A SUPERIOR SERVER 


STAftT with the 
most ath/anced client- 
side SDK on the 
market: cTree'^ Plus 
at $895. 

• Complete Source code 

• ROYALIT rUEE 
{Client Sidcl 

* Mullipic supported 
protocols 

* Fiisl, tjfjrtablc, reliable 

* PowcrFul features like 
tninsaction prui^^ssing 

• Wiii93. NT. and 
Window^ 3-1 ready 

J\OD a strong, 
multi-platform, 
industrial-strength l 
Server that support^ 

* Pile miiToring 

• Heterogeneous networking 

• Automatie disaster recovery 
' Multi-threaded design 

* Best price/perforrnance 
available: front W45- S3745 


RESULT? 

A solid, economical, 
easily deployable 
product that fits 
your needs. 

^ l^irtahle 
« Sealable 

■ RxceplItniHl Perfumiance 

* Flexible 

* l-jiity Server dislHhution 

* Convenient OEM terms 

FAIRCOM*" 

Server 


I 




Hestenriyer leLtusB 
TCP/IP NBtwor+i 


You can't find a be^ar* clienc SOK with tf?a» fuaturus! 
Ovor suit^n yEEu-s of prorueo roliahiltty and |»r4brmant%. 
No one else supports over 30 platforms in this price range! 



c-tree Plus® 

» Complete C Source 

* SLngJc/MuJti User 

* Client/Server (optional) 

- Full ISAM functionality 
» No Hoyalties 

* Transaction Processing 

* RxedAfariable Lfiigih Rtxords 

* High Speed Data/Index 
Coaching 

* Batch Operations 

* Flic Mirmring 

* Multiple Contexts 

* Uniiijrpas^d Porlabilily 


FairCom® Server 

• Clicnl/Server Model 

• rransaeiion lYoeessing 

• Requires <2MB RAM 

• Oiiline Backup 

• Disaster Recovery 

• Rollljaek Forward 
■ Anti-Dead lock 

Resolution 

• Cliem-sidc "C“ Source 

• Miiki til readi ng 

• Heterogencotis networking 
» File MirrorinR 

• OEM/Source Available 


FOR YOUR NEXT PROJECT CALL FASRCOM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CLIENT/SERVER SOLUTlONr 

Also inc|urrc about these FairCom products: 

d-tree'” 
r-tree® 
ODBC Driver 


.FAIRCOM’ 

COFM=>OFtAXIOI\l 


Snee 1979 

WUVWeb Address: ittp;//www.faiOTn.iirTi/ 

sao-a34-snBO 

U.S.A. phone (S73) 445-6833 fax (573) 445-9698 | 
EUROPE phone (035) 773-464 fax (035) 773-806 
JAPAN phone (0592) 29-7504 lax (0592) 24-9723 
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OPEMSTEP 


by David Neumann, System Engineer, NeXT 


An Introduction to WebObjects 



An overview of Apple's new 
high end application 
development & deploymetU 
vehicle for the Internet 


This article gives a technical 
intrcxiuction to NeXT’s WebOhjeas web 
application development fjlaiform. The 
content is primarily geared toward 
develo|>ers witli at least some Internet- 
based application building experience. 

First and Ibremost, WebObjects means 
.server-based applieaiion development. It is 
not an authoring tcxjl. Wlien you layout a 
page with WebOhjeas, you are laying out 
your application’s user interface. 

WebObjects as a product ships with 
tltree major a>m[5onenLS: a tnxss-plaifonn set 
of object-oriented fnimeworks, developer 
tools on to}) of those frameworks, and a 
deployment infnistnjcture for running apps 
built on tiicxse frameworks. 'IhLs article will 
go into dc^tail on all three components. First, 
we'll delve into ‘^Logical Architecture" of the 
frameworks, and then ‘ FhysicTil Architecture” 
of deployment, and finally r<x>ls ik custom 
ctxle used to mre the funciionatity logeihen 

Althougfi WebOhjcx.ts is full of highly 
extensible oljjecLs ideal for heavy-duty 
ctistomization, WebObjects also includes 
Ux)ls tliat make it a first-class ‘'RAD" (rapid 
application development) environment for 
the web. For instance, WebObjecLs includes 


drag-&-drop access to induslrial-suenglh relational databases and 
offers a Database Wizard for creating complete datal)ase-aware 
applications (or parts of applications) with a lew mouse clicks. 

Note tiiat a developer may elect to write a WebObjects 
uf^plicaiion in either Java, Objective-C, or W:bSt:ript. Vimially all of 
NeX'Fs examples slii[> with both java and Objective-C/W^bScripi 


WebObjects as a product ships with three 
major components: a cross-platform set of 
object-oriented frameworks, developer tools 
on top of those frameworks, and 
deployment infrastructure for ruiuiing apps 
built on those frameworks. 


ecluivalents. However, the developer dex^s not have to stick to a 
single language, all three may \yc uscxl simulfaneoiisly. For 
example, NeXT enaHirages the use of a compilcxJ language like 
Java or Objearve-C for bu.siness logic (for example, rules, policy, 
and vertical-oriented computations) and WcbScript for “application” 
logic (such as, when you punch this button, ,select this field and 
jump to page XYZ, etc*)* 

IxKiKAi* ARr:HrrEcnxiRE 

below is a Ux)k at tlie logical architecture of the WeliObjccLs 
family of framewoiks. Frameworks are the prt^gramming building 
blocks of the largest granularity. These frameworks include: 
Foundation (the nt)n-(7Ul aspect of die OpenStep spec), Enterprise 


David Neumann has lieen a Systems Er^gineer with NeXT Software for nearly two years. Using WebObjects. he has assisted 
many customers with wd) af^pUcatton pmotypes and pnxiuaion online appiicatiun.s including that of a major PC axtiputer 
vendor. He has also written WebObjects software (available as an example on CD to WebObieets 3 0 citstomers) enabling the 
nianageinent, monitoring, and administration of disiributcd, large scale WebObjecLs applicaiitjas. 
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Increase Your Software Sales 


WIBU-KEY™Copy Protection provides the most 
secure and flexible software protection available. 

WIBU-KEY has been protecting software around the world 
since 1989. WIBU-KEY combines the most sophisticated 
encryption technology with the highest grade hardware 
components to give you peace of mind that your software 
won't be used illegally. You've worked hard to create your 
Mac application. Doni settle for anything less than the best 
copy protection system - WIBU-KEY 


Hot plug 'n play ADB design 
Network support built-in 
Protect multiple applications 
or program modules 
Secure Remote Programming 


Consistent API for Mac and 
PC development 
User-friendly setup and 
diagnostic tools for your 
customer 


1617 St. Andrews Drive * Lawrence, KS 66047 
Tel: 913-S32-2070 » Fax: 9l3-a3£-S78r 
^ Email: sales@gritt 0 ch.com 


300-3c6 vfiS 

www.Briftechj:om 


SYSTEMS 


™ Rueppurrer Slrasse 54 • 76137 Karlsruhe • Germany 
I Tel; +49^721-931720 * Fax: +49-721-9317222 
Email: info@wibu.de 


Selglum, Lux. Compusec Tel: +32-2-e450S+4 Fsx: +32-2-0464266 Croalia Arles D.0.0, Tel! +365-1-222752 Fax: +385-1-2326535 Eslonie Laosoft Ltd. Tai: -r372-2-444780 
Fax: +372-2-662760 Japan VlSUSl Networks Co, Ltd. Tel; +61-3-340-67801 Fax; +61-3-340-57818 ■ Nalherlands Coinpusec Tel: +31-53-5740223 Fax: +31-53-5726622 


Objects Access (hitlirecikmal RORMS-io-objeci mapping), 
Knteiprist? OhjccLs CorUrol (fx^rsistent ol>ject transaction 
management), and Wetolijects (well presentiition ik deploynu^nt). 

Note that you may have an application sfilii inlt> separate 
service.s or Hers that use all of die frameworks and/or only 
Foundation and/or only Foundation+Enterprise Objects 
Access Sc Control, it is also possible to write a WebObjecis 
applicarion that only use.s Foundation and WeliGbjects (no 
object/relaiional datasource). See the .side-bar "WebObjecr 
Class Functional CrfHipings** for derails aboui classes available 
in the WebObjecis Frameworks. 

All afiplications must include the Foundation Framework. It 
provicles basic services needed by any prognini. ft is also the layer 
of objects that provides opcrrating .system inde|Krndence. In oilier 
words, you sliould never luive to make a direct system aill again 
for most uppliaitions when you have the luxury of using 
Foundation, Foundation provides operaHng system indejxndence 
across die upcoming Rha[)sody OS for Mac, Window's Solaris, 
IIF-UX, and of course NeXl '.s OFHNS^l 'HlVMach openuing system. 


Visit MacTech Magazine’s Web site! 

http://www.mactech.com 



Figure L Wch<)hj(x:Ls Frammmrks. Foumiaikm proiides 
of>Lrafing sy^stem independence, Fnierpme Objects Access 
pnmdes IU)BMS indepe ndence for ohjecl /K^rsvikmce, Hniet^nt^e 
Objects Control protfkies object (xfrsisience transaction 
management, and WehOhJects provides objects useful for ueb 
based presentation and deployment. Note that actual Unking 
dependencies are different than implied in the figure. 


The Fnlerpiise Olijects Frameworks (Control Sc Acce-ss) also 
km>wn collectively as “EOF" are extremely feature rich. Truly 
doing EOF technolog)^ justitr w'ould retjuia* an entire article 
unto itself and .so unfortunaLely tills discussion can only skim the 
surface. Consider diat EOF is NcXCs third generation solution for 
database aware appUcatitins, Hie sidelrar on ""WebObjects Class 
Functional Groupings" should give the reader at least a flavor for 
whaLs available in the technology. 


May 1997 • MAtflKcnM ahazinf. 


An iNTKonuci ion to VVriiOujBXs 


11 























It's EOF that facilitates i!ie use of rnie business objects in 
Wel>Objeas. EOF makes your application cunipletely database 
and schema independent. With it, you can create ""live” eniiiy- 
relationsliip diagrams in a tool called *'Enteq'>rise Objects 
Modeler'' (or just ‘^EOModeler") tliat sliips with WebObjects. 
EOModeier will emit new schema and (perhaps more 
importantly) let you teverse engineer an existing relational 
tiitabase into a default object mapping — that you can then 
en I lance without affecting the underlying schema. You tan write 
business logic in itie same language you write your application 
c(xie and take advantage of lx)th composition and inheritance 
relationships in rliat business logic. This is highly dilTereni from 
“nonnar approaches to database driven applic'atioas: 1) forcing 
policy into a proprietary, database-specrifit' stored procedure 
language (not object-oriented) or 2) scattering lousiness logic 
atToss applications in event handlers. Furthennore, EOF makes it 
trivial to build applications that integrate nesotirces from several 
databases — not just one. Add-in technology from third parties 
allows you to extend this integration to mainframe applications 
via 5270, 5250, and ASCII data siieanis. 



Fijfure 2 EOMfjdeier appHcalion. Hm kxd ships with 
WeiyObjects lo lei dmKdofx^ graphically create entity 
relationship model of their hminess uhjeas^ 'the model can f)e 
targeted l<f any datasource known to WehOhjecis indtuling 
Oracle, hi/ormix, SylTase, and ODBC. Note hote the atirihule 
(mamet) on the selected entity (IStudm) is ahstractedfrom its 
external database name and type. If the datasource changes, 
oniy the exienmi information need change insulaling 
application code from the database imptementation. 

The fundamental difference lx;iwcen WelK^hjeas database 
access t:ompared to traditional data access mediods is this; when 
you fetch a “row" from a database, you do nt)t get naked data, 
you get an object w'ith behavior, an ol)jeet that knows alxiui its 
relationships to other olijects. You get an object that is watched, 
uniqued, deleted, and uptkted from within a document context 
(kind of like a super transactitin) with automatic support of 
undo, redo, revert, and efficient change Hushing to the 
underlying daialxise or databtises. You specify the kind of object 
you get for a row (for example, its Class) using EOModeier 


Since the business objects you create wiili EOF don’t care 
alx>ut the underlying datal^ase or how their values are presented 
in user interfaces, they may Ik: re-used over and over in any 
nurnlxir of different applications (web, Windows, or Macintosh 
Rhapsody) and indeed may be maintained by a crew of 
developers only loosely coupled to thexse building specific apps. 

PlIYSJCA!. ARCHm-fTURF 

Now that we know' what kincLs of building blocks are 
available from a developer's perspective, how does that 
logical architecture get laid out physically into a running 
application? Figure 3 shows the tiers involved in a typical 
deployed WebObjects application. 

Unlike traditional modes of Internet prtjgnimmiiig sudi as Peri 
scrips, a Wel)01>jccLs application dtxis not “dmppear’' between page 
paxessing/geneiation timsactioas. It stays up and maintains a 
persistent ckilabase cx^nnection. The task of state managemeni is 
completely suKsurned by the WebObjects framework. State 
maruigement is also alistracted to ifie point that altemative state 
managemeni policies may lx? implemented wiili little or no impact 
oi\ existing ctxJe (such as, state in the pftxess, state in the file system, 
state in the page, state in the soincpiace-noFinvenuxl-yeL, etc.). 

With WebObjects, browsers interact witli HTTP servers in 
their nonnal way taking advantage of any technologies dial 
enhance this browser-lo-web server link. For example, secure 
socket layer communication protocols in Net.scape and 
Microsoft hrowser/.server products. 



■ULLL. I1.IIIJ 







Figure WebOfdects Dtptoyment. Browsers communicate with 
IITIF sensors which communicate with the WebObjects aeb 
seriKw adaptor. Ihe WebObjects adaptor toad Imtances across 
one or more application sens.^rpnxesses (also called insiancm) 
running on one or more machities. Once mnning, WebObjects 
application instances do nui go mmy heiuHten user requeds; 
they maintain ihemehm, their sessions'state for users, and 
their database connections. Ihey are efficient, fast, and by 
deftnilion, redundant. 

It's the jol) of the UTVV server adaptor, as indicated in 
Figure 3^ to communicate wiili a given HTTP server and forward 
requesLs to one or more applicatitjn “instances" — an insLance is 
a separate copy of a given applic'ation process. A Wetobjeas 
app serving a few users may liavc only one instance. A large 
application may have tens or hundreds of iasuinces running on 


12 


An iNTHooumoN TO WiajOtpcrs 


MAC^KCHMAfiAZJNE • MaY 1997 





































WITHOUT OS THEY 
WODLON'T EXIST 
|0R AT LEAST THEY D 
61 MUCK MORE 
FRUSTRATED.) 


Ameilci Online 




Broderbund Software 


Canon 


CUrU 


CompuServe 


Dataware 


Digital Egaipmenl 


CE Information Systems 


Macromedia 


National Geographic 


Now Soitwire 


QualComm 


CONSIDER the possibilities. They’re 
wide open. Simply put, OpenPaige*^ can 
do anything you want to the text of your 
software application. 

Across platforms, across architectures, 
even UNIXOpenPaige is a feature^rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-rectangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don’t waste time struggling with youi 
text. We’ve already done the work for you. 
Drop in OpenPaige and go. Use as much or 


as little of it as you wish. Available as 
object code or as source code, it has 
an elegantly small footprint. Yet it wlU 
empower you to open doors, boundaries, 
and minds with your software application. 

But don’t fake our word for it. Check 
out our extensive and diverse client list. 
They’ve all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 
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For additional Mormation, check out our liwb site at or call us at l-800>327-B263. 
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Macintosh- 

The Industry Standard for 3D Graphics 

Port your code from other platforms with ease! 

Workstation Class Performance art your Mac 

Complete on-line documentation and support 

All common support libraries provided 

Multi-processor capable 

UNIX or MKLinux versions 

Works with most compilers, including CodeWarrior 

Callable from C/ C+-i-, Ada and FORTRAN 

Full Technical Support 

Custom Libraries available 

Conix Graphics 

Download free demos at: 
www.conix3d.com 

Let your imagination fly! 



Sales Technical FAX 

800.577.5505 817.467.0461 817.467.9452 

sales@conix3cl.com 
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one or mow t lines. If an ai>plicali<jn has riKjre than one 

instance, tlic WehOi^jects adaptor is essentia[ly acting as load 
balancing agent. If an instance fails, it is only affected — oilier 
instances and/or tfit* site’s web server is unaiTecteLl. 

WebOlijecis IITH^ ^Nerv'er adaptors come in three flavors: 
an N'SAFl pkig-in, an LSAPl DLL and a very low overhead CGI 
program. These adaptors are written in pure C and all of their 
source is incliRled witli WebOlijects. This was provided as a 
portability integration strategy, Consider that Wc?bOl>jecis 
applications may reskle on the forthcoming Rliapstxly, Solaris, 
Windows NT, etc., but not all operating sy.stenis. To facilitate 
plugging in a cluster of WeliObjects Appliaition server boxes 
into an existing infcisiructure of, say, SGT HTTl’ servers, the 
devek>j>er may recijmpile the desired wx^b server adaptor 
flavor lor their target operating system. 

‘Ihe adaptor will forward retfuesis over tlie network as 
easily as it will forv^ard recjue.sts to applications running on 
tile saiue box as the IITT!^ server. In fact, from a load sharing 
perspective, it is ideal for tlie HTTP server and Application 
serv'ers to reside on separate iKixes. This way, WebOhjects can 
generate images t>n tite lly without competing with the IH'IT 
server's CPlKs) that may already he quite hnsy ventling f>ut 
the web site's ^static’' HTML pages, 

^ince WelK)lijc‘cts applic’alions are server liased. database 
access happens behinci the firewall Browsers netxl never make 
direct connections to a cLitabase server. DaUtbase connections arc* 


therefore liighly secure (only accessible via actual ap[>lication API), 
anti t'onsttrved (iliai is. y<jii never have ntoiv than one cnnneaion 
instance regardless of tiie numlx^r of users supported — unless 
thus is specilk'ally something the tlevelofKT desires). 

Any brr>wser can be a WeljObjecis dteni since only standard 
fflWlL need !x" generated on the fly by the WelT<^bjetts sender. If 
the dcweloper desires a more atlvanced kxjk ^ feel, tfien otlier 
ccmteni types may also l)e generated sucii as lava applets. 
Wel)Ol>jecLs essentially makes a distinction lietween client Java 
and seiver Java. Client Java is nsed ro enhance die user imcrface 
(e.g. a Calendar applet, a simy)Ie fieki validation applet, etc,). 
Server Java (and/or server Ohjet1ive-C/WebScTipt) is used to 
customize dte WelTOhjects fntmewt^rks to the business k>gic and 
iKdiavior requirements of your application (for example, a 
CusioniLT object, a stai-gathei ing Advertisement component, etc.). 

In addition to liLML and HTML cmixalded waili Java 
applets (and/or any other cfieni side tedmt>logy driven by 
HTML content, e.g. ActiveX, RealAudio, etc,), WeliObjects 3-1 
includes one new content generatitm feature: support for 
dynamically filling in ‘'Idanks" in IDF tkK:umenLs using Adt)be’s 
new FDF protocol. This capability lets WcbObjects applieatioas 
create visual ly appealing and printable reports, forms, and 
catalog pages dynamically. 

Programming a Wfr()ujf.(ts Appikatioim 

While all operating sy.stems sup|X)rted by Wei>Objects are 
development platforms in I he .sense that they all sup|X)il building 
WebObjecis applicaiitm executables, Windows NT, 
OPENSTEP/Mach, and Khapstxly are conskleretl the ^preferred’* 
development platforms becausi* only on the.se pkufomis are all 
of the graphical tools sLijqxHted. dliese UkjLs include WebObjecis 
Builder (a w'ei>imenlLx.l user inierfuce layout tool w'irh drag & 
drop database access), FOModeler (the object to RDBMS 
mapping tool for al>simciing your dalasources), and Project 
Builder (a project management, compiling, ik debugging 
environment). If your appliairion uses only WebStripi, ytru will 
not need the managemeni serv ices of l^rojcTi Builder. 

All resources in a WebOfrjects applitution nw placed 
underneath the applications "wmpper" which has a ^wca" 
extension. For example the D(xlgeIVino database-fed catalog 
application that sfiiyis wiiti WebObjecis is actually a directory with 
the name “DodgeDemo.woa” filled wttit rescjurces. These resources 
include components, pagers, images, scriyas, sou tee files, etc. 

You u.se Wel)ObjecLs Builder icj ciViite your application’s 
"coniyxjiicnt.s" wJiich are a,s.sc'miilcd ints) ihe y'xtges the usct see.s. 
Some component.s re|Trt\simt a p-ige in total. Some reyjrescni a part 
of a pge (like a kxjtcT), ComixxienLs cm Ik' nested wathin catch 
Ollier. Action handlers rejKe.scmiing a cximponeni's Ix'havior may lx.- 
expresseti in WebStripi, Objettive-C, or Java (or no ctx.lc at all if all 
the iTehavior Ls in comfX)nenLs y^a-lmilt i>y ytm or NeXT). Figure 4 
shows the WV^iObjec'Ls Builder wJiile a .standard reusable 
comyxinent (tJie WeliOl^jeGs active im:ige logo) is Ixang dragged & 
dropyx'd on The Main c:omponeni oJ' tfjc HelloWorldJava application. 
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Figure 4 WebObjects Builder’ user interface ia\Kml. Here a 
prehuilt comixment (the WebOhji^is active image logo) is being 
dragged and dmpped onto the HelloWoridJam applicatkm's 
page HTMt '"camm^ 


Note lliat tlic upper pane shims the coniponeni’s visual 
layout while the lower pane shows all t>f the methods and objects 
known lo the eornfxjnent. Methods jtv listed Ixjbw the line in the 
lelt-Mioist bn)w.ser coluiiifi, variables above it. We see that this 
eoniptment has defined an action methcxl c:i)Ietl “sayHelki’* and an 
instance variable called visittjrNanie. Notice that all comf>onents 
have access to any variables and methods inii>leinentcd on the 
Session and Application via tlielr restrictive t^ntries in this browser. 

Using WebObjects Builder can be summed uii as the act of 
assoc iating nielliotls and variables in the lower pane with the 
pro|XMlies of custom and NeXT components placed on the page 
canvas in the top pane and repeating this prexes^s for however 
many of ycnir ciisioin coinponenis make up the applicatiori. 

When you add ctxle to a comj-Jonent (regardless of the 
language usexi), you are sulx'lassing the Wt‘l>Ol:)jects class 
WOCornponent (or your own sulxiass of WOComponent), A 
comjKKieni definition is stored in a folder with a "wo" extension. 
Every component inclucle.s tlirce basic files: an HTML template 
(which dellnes pure layout)* a code file (defining pure beliaviorX 
and a \leclarjtion" file llial maps the two togelluT, Using this 
approach, code can change without impacting layout and 
formal/look can change witliout impaciing ctxle. It also makes it 
siraiglttforward to delegate HTML look Issues to a third party tlxit 
may have special expeitise in page layout. Developers can 
import the ITt Ml, at a later date for llie final application release 
(or change the look dynamically while the application Is 
mnningj. When you edit a ccmiponent in WelXJbjects bittlder* it 
manages all of the component's resource files transparently. 

All afipliailions include a WOSession and WOApplication 
olrjert whose Ixhavior you can customf/e w'irh ccxle in either 
WeliScrtpi, Objective-G* or java. Any variahles you declare in your 
WOApplication sulx'lass represent A[>plication scope* (for example 
an anuy of URLs (X)inting to third party sites). Any variables 
ckx’lared in your WOStission siibclas,s represent Sessit>n sco|x: (rt>r 
example, a user's sliofjping cart or active sc*lection). Any variables 
declared in yt>ur WGMJomponent .subciitsses represent component 
scoix* unique to each crjmponent (for example, the disclaiincT 


siring in a footer component). Components tend to last for only a 
single transaction* sessions last for many transactions* and an 
Application cf>ntains many sessions. 

At your discretion, you may elect to override several important 
methods tliat allow aistomization to the event handling pitxess. 
These include* but are not limited to: ""init" — called once and before 
anything else on object creation, “awake'' — called Inefore aaion 
liandling on every request, ^‘sleep" — <'alled at the end of an event 
on every reriuest* and “dealltx” — callcxl rigltl IxTore the abject is 
destroyed. All four metliods may be implemented at all three scope 
levels (i.e. in your Application, Session* and Componeni sulxlasses). 

fk^Iow is source code for liic HelloWorld example's “Main” 
f)age. The Main page is the very first page that gets created when 
a new session is created. This example is implemented in Java. 
You can acces.s a component's axle via the ccxle inspector as 
indicated in the Figure 5. 



Figure 5. WebObfecLs Builder shoumg code inspector with 
Main component’s sayliello event handler and mitorName 
instance mriable dijtned imide. 


Listing 1: Main.java 


A tusium stibclass of WdXXifCcts Javn class "Componcm" (WOCrimponent in the 

J:iva name space), llic MeXT Java fratiieworb arc LmptJried as nexi.iiill/ and next.wo/. 
nXs suIxJash dedatt.s a Java Strini^ as an instance v;iriahle and a single atiion method. 

iinpori nexr.jrtl.*; 

IjQpotL next.wo.*: 

public class Main tfxtends Coiaporcnt 

String visltorName; 

public Coiaponent sayHalloD 
( 

Hello ncxlPnge = 

(Hello]application 0.pageWlthNamc("Mello"); 
nextPage. setVisl torllameIvlsitorNatne): 
return nextPage; 

) 

I 
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We see that the class Main is a subclass of Cotnpoaent (the 
(:la.ss name of WOConiponent in the Java name space), lliis 
component Ls also the entire page. It declares a single page 
variable, visitorName, and a single event handler method, 
‘‘sayHelloO”. 'I'he first line in the method invokes the method 
“pageWithNameO'' against the A [) plication object. All 
WOCJomponents inherit a method ^appIrcationO" tliat returns die 
appliattion object for convenience. pageWithName() takes the name 
of the [)agc instance you’d like to gel a neferenc:e to as an aigument . 
If it finds the page defined in your applicatic}n wrapper, it returns 
it. Here we’re taking the returned page object and assigning it to a 
variable “nexlPage”. fn die next line, we invoke a method on 
nextPage 'setVisitorNameO”. Finally, on the diird line, we mturn 
nextPage which means this page will define the lesponse for this 
LransacLion. If we had leturned ^^self', the same page that handler! 
tlie [Previous request would make u]) tliis iies|K>nsc\ 

You may be wondering where the value for vi.sitorName is 
gening set. In WebObjeets Builder, HelloWorlcFs Main 
conij^onent has a single WOTextField object whose value 
property has been mapped to this component's visitorNanie 
instance variable. This means that whatever value it has on 
page generation will fill the textficld upon display, and any 
value the user enters will get automatically parsed and placed 
in this variable by the time your action method is invoked. In 
Figure 6, WebObjetts Builder’s element inspector is fcKusscd 
on the textfield. Note that the textfield's value property is set 
to the component inslanee variable. 
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figure d WehOfy/ecIs si70?Mng 

With its value property mapped to the higbtighled visitorName 
component instance mrtable. 

If we wanted the lextfield to have an initial default, we 
could elect to set it in an awake method for the page as 
shown in Listing 2. 
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Listing 2: Main.java 


awakt 

Set a default vnlue for the vmicorName iasitince rjriable hy impknienting the 
WtXloJUptment's awake method. 

[jubllc avakcO 
I 

visitorNanie = "David": 

I 

listing 3 ?>hows how the Hello page’s custom beiiavior 
would he iiTiplernenied in java, Tlie Hello page is another 
suix’lass of WOComponem used as the response to die 
"sayHello” action defined in the application’s Main page. 


Listing 3: Hello.java 


This subclass of Coniponunt dtfiaLS the custom bdiavior of the Hello page used as 
a ixsponse for the Main jjage's action mctliod. It also declare,'? a visitorNarne 
iusianee variable, 

import next.util.*; 
import next.wD.*; 

public class Hello extends CottiponeiiL 
f 

String visitorName; 

public void setVisitorName (String name) 
f 

visitorName = name: 

I 


public String visitorName () 
f 

return visitorName; 

) 

1 

Note that using WehScript can reduce the niimtier of lines of 
code you need to write becay.se it automatically adds default 
"accessor” methcxls like those used in the Hello page above to 
set and get the vLsitorName instance variable. For example, 
Listing 4 stiows the same Hello page implemenied in WebSeripL. 

Listing 4: Hello.wos 


Tlifs’VPteb&ript file has oue lioe — a declaration of the visitorNome instance 
^■ariabk At runtime, this rdc is parsed by WcbObjccts and a subclass of 
WOComponcnt is dyiiamJcally added to the runtime with the developer's custom 
methods and instance variables. 

id visitorName; 


That’s it. 

When yoiTre done editing your source, you use J^roject 
Builder Lo create the appUcalitm’.s executalile. Figure 7 is a 
.screen shot of ProjectBuilder and its build panel being used to 
create the HelloWorldJava executable. 



Figure 7 ProjeciBiiikier shown here while building the 
HelloWorldJava application in the background. 

Figure 8 shows how to add database access to the 
HeiloWorldJava application. In Figure 8, a Cu.stomer entity 
defined in EOModeler is dragged and dropped into the 
WebObjects Builder component window creating an instance 
of a WODisplayGroup that will manage Customer objects 
fetched from a darabase. By mapping properrie.s of HTML 
widgets to attributes and methods provided hy the 
WODisplayGroup, information from the underlying databa.se 
management systems can be displayed in the user interface — 
with any business logic txing enforced transparently, thanks 
to the inteiTening objects. 

continued on page 22 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes... 



On Macintosh 


Find Bugs Fast 

Spotlight is the first Auti^niatie Memory Debugger for the 
Maemrtiish. lusiautiy detect invalid memory acetskses, had 
toolbox parameters, leaks, stack overwrites, memory reloca¬ 
tion problems, Hotl nuich mi>re. 

SfKJtUgliL uses youf XSYM file to auttimaricHlIy paLeh your 
application — no need to change your s(>uTce code, No need 
to recompile. No learning curve whatsoever* 

The interlk^e gives you instant feedback when an error is 
detected. You can ignoie the error, ign<:re all future occurrences 
of the error, t>r log the emjr to a text file fi>r later analysis. 

Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applica¬ 
tion and system heap. But it docs not stop there. Sixjiliglits 
Object Code Replacement instnimentaLiOEv inspects each read 
and write instructitvn in your code, detecting faulty memory 
reads and writes that occur between bltx:ks, in released blocks, 
across multiple blocks, and m ROM. 

This technology wtjrks on any heap object you can allo¬ 
cate: Mac heap objects, C'malloc' heap <objects, even Ct+ 
objects created with new. 

Spotlight stops yijur application whenever a faulty memory 
access is about to occur and displays the exact S4)urce code 
line where it will happen. The calling stack is shown along 
with a display of all variables. A memory' viewer shows the 
erroneous memory ai,ldress and contents. 

Toolbox Validation 

Sp<idighi checks parameters to over 400 ttmlhox API calls, 
automatically validating handles, memory hUicks, return vah 
ucs, and so on. Specific checks catch subtle errors such as draw¬ 
ing into an unltKked UWorld, passing an invalid window 


pointer, passing an address within an unlocked handle to a 
nairine dint m;iy move memory, and tixi many more to fist. 

Le^k Detection 

Ntj more struggling with MacsBiig. On pnigmm exit Spot¬ 
light provides a clear listing of all leaked memory showing a 
full stack trace from where the memory was alkKiitcd. In.sfantly 
discover all leaked Mac OS objects, malloc'd objects, 
C++ objects, and resources. 

Limitations 

Spotlight requires an XvSYM hie to function. MFW and 
CcxleWarrior users can generate these directly. Symantec us¬ 
ers must use ToolServer to fink with an XSYM capable linker. 
Spotlight rajuircs a PowerPC processor. 

Sptirlighr works on file object code. No source code Is re¬ 
quired: just die thing for testing purchaM^l third jiarty libraries. 

Availability and Pricing 

Pricitig for Spotlight DRl is $199 US (plus $5 shipping and 
handling within the continenial US, $15 for imernatkmal 
orders). This includes a free upgratle to the GM version and 
access to ftp interim upgrades leading up roGM. QQ users can 
cross-grade to Sptitfight flir only $ 149. 

All Qiyx products carry a 30 day no question.s asked money 
back guamntce. 

Onyx ll'chnoltigy, Inc* 

7811 27th Avenue We.sr 
Bradenttin, Rorida 34209 

sa les^onyx-tech .com www.ony x - tech .com 

941 795-7801 941 795-5901 (fax) 



SfxniiRlft and Qt' iw criit,k'iiia[li!i ijf Ortyi Ti'i-lwiilney, Inc- All cjfhcr iifmiicmiiirti* iwv pn’ptTty iiliL-ir iiwticnL 
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figure 8, WehOhjecLs Buikier shoumg how to access objects for 
eriHHcs fkJine<J in the fOMadeler application. 

Figure 9 slu>w,s Wel>Ohjert.s Buikler while the itser Is 
selecting options available in the Data base Wizard tool. 
Specifically, WebObjeas Builder is prompting the user for the 
database type the developer would like to connea to. 


WebObjfcts Class Functional Groupings 

In a (ypk:al WelObjeas Enterprise application there are six 
workhorse classes from the Foundation Framework that get used 
all of the time: 

NSString, NSHutableString 
NSArray* NSMutabl^rray 
NSDictionary. NSMutablftDict-ionary 

However, I here are many others you can leverage. Here's a 
groujang of mlatcxl classes. Note that the same chss has been 
included under more tlixta one category wIutc appnr[5riaie. .Also, note 
iliai all but the WelObjeas Framework is a>mman to OPEN*STE!P 
apps. Instead of the WcIjObjects Fnimework (optimized Web Ul/Web 
Deployment), Ol^ENSTFP includes tlic Application Kit Framework 
(Display PostScript III, drag & drop, pasteboard services, etc.) 

- Q|)eration Processing: 

NSOl^jett, NSInvcxiition, RSMetliodSigntUuiv, NSFxcc-fiiion, 

NSAssertionHandler, NSRunLoop, NSTlniei^ 

- Object NotiricaUon 

NSNotihention, NSNotilkationCenter NSNodficaLionQueue 

- Object Distribution: 

NSConneclion, NSProxy, NSDistantObject, NSRtinLoop, 

NSCoder 

Program Hnvironment: 

NSPrtKUssInfo, NSlJ.serDefault.s, NSAutoreleasePool 

- Persistance: 

NSCotlei; NSArchiven NSllnarcliiver, 

- Titiie: 

NSDate, NSCIalendarl>atc, NSTlincZonc, NS'nnie^xjndX^kul 



Figure 9. WehOhjects Biukier showing ahrmid neu^ application 
being comtntcteci with the Dakthasc Wizard. 

HelloWorld is, of course, a very^ simple application. 
WebObjects however is most appropriate when building die 
most complicated applications. Figure 10 is a screen shot of a 
non-irivhl example application that ship.s with WebObjects. It s 
called the WebObjects Monitor, it is used to remotely 


- Thread Control: 

NSTluead, NSLock, NSConnedion, NSRecursiveDxk, 
NSConditionLock, NSRunLoop 

- .Siniciiired Data: 

NSAiray, NSMuiahleArniy, N.SDict.ionary, 

NSMutableUtctionary, NSSet, NSMutableSet, 
NSCoiiniedSet 

- Data storage as olijects: 

NSValue, RSStiing, NSData, NSMutableData, NSSerializer, 
NSOeserializef, NSCharacterSet, NSMutableCharacJerSet, 
NSScanner 

- Interation 

NSEnumerator 

Here are some functional groupings for the WebObjects 
Framework. 

- Request iSt Response Handling 

WORequest, WOReS])onsc, WOApplication 
“ Stale Management 

WOScssion, WOSessionStort.', WOApplication, WOContext 

- I DTP Sender Adaptor Management 

W'O Adapt or, WOl^efauilAdaptor, WOApplication 

- Page objectification 

WOElemeiit, WOCoiiiptment, W'ODynamitElenient, 
Note: there are many sulxlasses of WOElement provided 
by the framework char may be used by developers. 

- Datasource abstraction 

W'ODisplayGrouin(*) 
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administer, monitor status, gauge performance, and provide 
faif-ovtT for ytmr applicaiion's instances during the 
deployment pliase of your project. 



Fif^ure 10. WahObjevL'i AhriitoK A n example of non-triviaI 
WehOhjects appticaikm. Jht paniaPar app is used to 
administer a WeMhJects application during deployment, fn the 
ahote screen shot, uHt see that the DodgeLiie application 
configuration is heirtg inspected, We detail information shows 
that it has cufTently l?een configured with four instances ftus) of 
which are nmning). 


In a typical develc^pmeiit scenario, virtually none of the 
Enterprise Objects classes descrilied below in the Acc:ess and 
Control layers will appear in y<Hjr actual source code (but tlic 
point is they can if need be for customization). The exceptions 
are tlie EODataSouree and EOQmlifier cl?Ls.ses. The modeling 
classes are configured using llic EOModcicr application, the 
Acktptor classes are encapsulated in your lUJBMS adttptor, much 
of die other classes are created by other classes for you and just 
work behind the scenes. Tlicir APIs are available if you need 
diem, and diey may be sulx'lassed, categorized, and/or hooked 
up to delegjues to fine tune their behavior- 

in die Enterprise Objects Access Framework there are these 
class functional groupings: 

- Accessing specific relational datastores 

HOAdapior, HOAdaptorContext, EOAdaptoChannel, 
EOSQtQualifier, HOAdapioiOperation 
Note, subclasses of these classes are provided by NeX^l' tor 
Oracle, Syl>ase, Informix, and ODBC client libraries. In 
addition, an example wiih complete' ,soLirGC is provided for 
a version ihit! uses the file s)^stem (FlatFileAdaptor). Sc^unce 
is also provided to the ODBC adaptor so developers on 
vvriie ihcir own aLSUvm adaptors if iliey like using tliis 
adajitor as an example basis, 

- Mapping any custom adaptor to objects 

EODatahase, EODatabaseContext, EQDatahaseCliaiinel, 
EODatabaseOperation 


SusmAKY 

WefiObiecXs provides framew'orks to give your app a logical 
head start, depk>ynient infra.stnicture to give your application a 
scalafile stnuture, and dcvelojimcnt itxils to help you create, 
maintain, and extend your application thniughour its life-cycle. 
'Fcxlay the uxil.s run on NeXTs OPENSTFIVMa('h optxaiing 
system as well as Microsoft)^ Windows NT I'hey will also l^e 
available soon on the next-generation Mac OS, Rhapst)dy, on top 
of PowxM'PC hardware. Regardless of w'hat platform you use to 
develop yotir application, you cun enjoy [)oital>iliiy wheti you 
decide to deploy it. The WeliObjeLts deployment runtime is 
available on Windows NT, OPENS'lEF/Maeh, Solaris, and HP-L3X. 

For detailed information about tising WetjObjecLs, clas.s 
diK orncntaiion. user guides, and training sehedulcs, visit NeXT’s 
web site at <http://www.nextxom>, Bi 


- Mtxieling an object graph to a RDBMS schema 

EOModel, EOMtxlelGnmp, EORelaiioasliip, EOAttribute, 
EOEntity, EOJoin, EOEntityClassDescription 

- Accessing Database Metadata 

EOSQLExpression, EOAda[iior, EOAdapioi'Channel 

- Store procedure utilization 

EOStoredProcedure 

In the Enterprise Objects Control Framew'ork, there are 
these class functional groupings. 

- Object Graph Change and IVansacrion Management 

EOEditingContexi, EOUndoManager, EOObserver 
EOObserverCenter, EOObserv-erProxy. EODelayed- 
Observer, EODelayeclObsen^ert^ueue 

- Object Storages Abstrataion 

EOObjcctStore. EOGloballD, EOEault, EOFaultllandler 
EOCbjectStoreCoordinatar, EOCooperatingObjectStore 

- Object uniqueing ID stamping 

EOTe[Ti[K^ran'GlobalJD, EOGloballD 

- Object Querying 

EOKey^ortOrdering. EOFett hSpetification, EOQualificr, 
EOSQLQuaiificT, EOAndQualificT, EOOrQualifier, 
EONotQualifier, EOKeyValueQudifier 

- Simple Source of Objects for WODisplayGroups 

EODaiaSr>urce 

- Enteq^rise Obiects 

Any class you like wirfi any inheritance scheme you like. 

m 
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What’s Inside OPENSTEP.. Really? 


An Introduction 
to OPENSTEP's 
Development Tools 


Tlic next HcvL'mJ will an 

attempt to give you a coiiiplete overview of 
OPRNSTHP',s development system as it 
miglil ix‘rtain lo KhapscKly. Of etnirse, we 
can't quite etwer eveiylliiiig, hut liojjtfully 
when you're done reading you1l know a 
liiile hit ahotti OI^KNHTKP’s basic parts and 
why developing under OPKNSTRP has 
brought a happy giin u.i the faces of .st> 
many lucky prognimmers, OPl^NSTEP Isn't 
[X*rfect, but it's a well-designed springlxKjrd 
for a Macintosh pRjgrantming aii;iissance 
during the next few yeitrs. 

The mapr elenienls of ()E*HNS1*HP are 
the Foundation Kil, Interface lluilder, 
l^Lsplay Postscript* and Objeaive-C. ^lltere 
are some iiii[K>it;inl iiiinor players as well: 
ITojeaBuilder, Header Viewer, Ubrarian 
and pswrap. All of ihest^ elemenLs are 
piTjbahly unfamiliar to you unless youVe 
used NFXIKITP or OPENS Moiv, so 
let’s Starr hy raking a quick run through the 
develo[5ment f)roccss under OPENS1T-F to 
see where the pieces fit. Well then go [jack 
U> lake a closer kxjk at the major players. 

Tiw Dfvtiopmeyi- Prckess 

1Tie tlevelopnient cycle under OPENSTEP 
Is fast enough tliai it tends lo leave you 
wondering W'hat you skipjx.xi when you'a' 
finished. Ill outline my own develo]>ment 
cycle liere; youll prf)h 2 ibly evolve your own 


techniques once you start programming under OHENSITP. 

I usually Ix’gin by designing classes. Tliis prtx:ess is similar 
in any mcxlern language; 1 figure out what data my program will 
u.se and derive a rough list of the major classes involved. 
Optimi/.ing for sjxcd versus effitiency, or .server storage versus 
Itx’al Stonge* maintainability or even communications bandwidth 
will influence the design of my class system. 

Over a period of alx>tu my first two years working with 
Objective-C I noticed that my lechnit|ites for designing new 
t^bjetas changed radically and often, 1 attribute tliat to the 
seemingly subtle* but huge differences Ixnween designing for 
Objective-C and for conventional languages like C or Pascal or 
even quasi-oop languages like C++. I lake heavy advantage i>f 
dynamic typing and dynamic binding* which are not available in 
jnost languages other than Smalltalk, Java is cuirenlly mostly 
statically tyixd as wdl, but JDK id has rellection, a clear sign 
that tfie language is evolving in the right direction. 

liiziiirely entjugli* I've gtXien if> the |H)int wiiem I write almast 
all my iwemew' dtxumentatlun Ix'lhre I write iiicxst of tlie code. Ill 
whie Lest t cxle to make sum a a>ncepPs going to work if iPs 
something radiail* hut Ibr the most part ilx^ ccxle’s completely 
dc*scriix*d lxTt>re it's written. I'm finished when any conitxtenl 
Ohjc'tiivc-C pRigrammer could write my app fnL>m my docs. 

Tlie dtxumenLaLion pnxe.ss is made t!asier by the fact that 
every Qhjectivc-C class is comprised of an interface file and a 
class implemeniaiion file. The interface file is a fancy header file 
lliiit contains all the class variables that might lx? needed by a 
programmer using the class, plus prototypes for class methexis 
and functions. When Pm designing a new ckms, of nece.ssity 1 
have to decide liow thal class will inieracl with the outside 
world. Whatever’s externally available gex’s in ihe interface file 
and, With a comparatively tiny amount of work* an explanation 
g(xs willi it into the thx'iimentation. Now IVe got my interface 
fileii and all tlie dcKumentalion sometsne would need to use any 
of the classes in my new app. 

At tills point HI either bind it off to a group of programmers 
tor them to complete or pa.sle the mclluxl and function prototypes 


Dave Kluigler is a computer sysiems architc^i who lives in Albuqcierque* New Mexico with his two dogSr Bruce and Sha,sta, 
lie Is currently working on virtual reality ujoLs under OpenStep. 
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from the interface into a new file culled tlie clajis implementaiion 
file and l>cgin filliojt* out the class. Ttiis m die file that will actually 
contain the cxide for ihe class, and If you want to sell your classes 
you ctin cosnpUe this file and sell tlie lesult alon^ with ilie Interface 
file and the ckxiimentation. No one gets yoursouae ccxte, but they 
do get an explanation of all the classes" exlemally available 
variables and nietlKxLs. Tlieir classes can interface with your classes 
without knowing what's inside them, and that, after all, is what 
objccL-tjrienEcTl progntmming is all alxiut, 

kits of people in the OPENSTE? world sell 4’lasses instead 
of applications. One of the first classes I bought was BcnaTong's 
Serial class, so that I cotild save some w^ork wanting a 
telecom i n u n ica lit) tis [ jackage. 

Because IVe got a list of method i>rolt}lype,s lo iintilenieni, I 
can just work my way (hroiigfi the file coding each one. When I 
reach the last tme the class wall l>e finished and quite often it “just 
works" with Utile or no debugging. 

After designing the classes, it’s time to pull out 
ProjectByilden PrujectBuilder manages the protress f>f building a 
new application, mtKlitie or palelie under OPENSTEl’. I tell 
ProfCTiBuilder to creaie a new- project^ c'reate a lew icons for die 
program and data files and drop them into ProjectBuilder’s 
various boxes, drop in the new classes and doul>le-click the “nib" 
file dial Project Bulkier has creaied ftir me, “Nib” ,s[ancLs for NeXT 
IntedaceBuilden and that file contains the elements of the 
interface for the program, arguably iiiosl of it. Using Interface 
Boikler might he cf>nipared to using a graphical version of 
ResEdil. but InterfaeeBuildcr dotrs much more. 

Next I design the rest t>f the program. Keef> in tnind thai most 
of the elements in the average program other than the oiic^ you’ve 
just designed (and ihcyVe usually very' few) are already running in 
the OPENSTPP OS. Tliis meaas that you on use “live" versions of 
those olijetis when you design your pn:^anris user interface by 
just gralibing wliat yt>u want off a palette. You can als«i put your 
new classes into their own palette and use ihcni uk>, 

TnierfaceBuilder allows you to de.sign a program and '"run" 
it widiout actually ever compiling it, because the code for any 
objects you Ye using other than your own has already been 
ct)mpiled. Tliai code is rtinning or at least available in the 
operating system as a shared library. When you’ve finished 
“drawing” your program the way you want it to work, 
including the classes you can’t .see but must be integrated 
anyway, you select “Lest interface” from InterfaceBuikier’s 
menu and Interface Builder runs tlic program for you without 
c:la.sses that it doesn’t have yet. It gives you a big Prankenstein- 
style switch lltal you can use to shut the program dowm if your 
experiment dt>e,sn't like to quit. If you don’t like the user 
interface, you can play wath it until it’s easy to use or docs 
exactly wliai you wanted. It’s far more powerful than an 
ordinary interface design program iKxiause you effectively 
have a graphical window into the guts of your apf>. 

To release my appiiiu^ii<m in other coimtrie.s 1 can de.sign 
nibs in other languages, QPEN.STEP has support for Knglisli, 
French, Spanish, Swedish, German and Japanese, Mtxst of the 
time iPs just a mailer of c:hanging the words on the menus. There 
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%iect 

Set 

Mdil SDK 


Mail 

enabling 
made easy 

Ifs iimi \mf\ tim eavy to odd tostom me^wging to 
your appliititions. Send tind tmm rmiil. Honrila 
atiochmenb. Just use ObjectSeL 


Ideol for Intomct/lntrnner onvimoments, ObjectSet 
gives Mfldntosh, @e ond Windows developers relioble 
APIs for MlWi SMTP oid POP 3 pfototds. ObjeUSefs 
rnyolfy flee sottwate components ore peifert for 
develapinp applications wfiidi require integrated 
mossogiog sarvicos, from commcrciol software 
packoges to custom corporate opplications. With 
Objed^t you benefit from moil protocals without 
having to learn, rode and debug them on your awn. 

Come lake u closer look ol our (ibrarles, 
dofiimontntiort nod dema applimtioris. They're on our 
Web just for you (hltp;//www.smQrtcodesoff,£:oiTi}. 
Download a free topy today ond see why ObioctSet 
APIs are the eosiest youll ever use. 


MIME, SMTP and POP3 APIs for Mpclnlosh, Be and Windows 
C + + class libraries 

Framework integration using Power PI ant, MacApp, MFC 

Docunieiitation, iamptes and reusable code 

MIME eacoding/decoding: Sase64, Ouoted'Prmlable, UUDECODE, 

BinHeXj AppleSingle, AppleDouble 

Send messages usiag SMTP, retrieve messages using POP3 

Supports Openlron spore MacTCP, BSD Soclets, Win Sack DLt 

Subscription price Includes next iwo upgrades free 

Portable mulliplatfortn version and source code also available 


SMARTCODE 

s ofTWAdr 

Smarttode SoftwoTe, Inc 
Pl»i]™:t847)?45-35?i 

htipy/v^ rom 

mhol«@^ttcodcsoP.aini 

In Eumpe: 

Phene;+33 4 67 S93O40 
Fmt I 33 4 67 59 30 4S 
htipy/iww. wrarttcMle.fr 
mtSDle$<©5mertt{jde It 


May 1997 • MAtTncHM.AcJAZtNT* 


WjiaTs lx,s]i>H OpknSiki*,,, Kkally? 


25 



















M Developer Tools to Support 
Adobe Adobe®Technologies 

Adobe provides a complete set of tools and 
services for your development needs. Whether you 
want to integrate Adobe Acrobat® capabilities into 
your applications, add PostScript® language 
support to your products or create powerful 
Graphics Application Plugins, Adobe has the tools. 

These Software Development Kits now available: 

^ Adobe Acrobat Plug-ins 
Adobe PostScript Language 
^ Adobe Photoshop® 

^ Adobe lllustrotor® 

9 Adobe Premiere® & Adobe After Iffects® 

9 Adobe PageMaker® & FrameMoker® 

To have informotion foxed to you, co!l (2061 626-5737 
ond request docunnent 1220, Or visit our web poge: 
http://www.adobexom/supportservjce/ devrebtions 


Adobe Developers Association 

345 Park Avenue. San Jose, CA 95110-2704 


are lcK:aiizaUan rirnis ihai spL-cialize in taking an English nib file 
and using it to create other language-specific versions of ilie 
piograni 'f'heyll send back the nib and you can dri>p it into 
l^rnjertRiiilder- llicy'll also iranslaic oilier messages tliat reside in 
your code if ifs needed. In most cases your app will "jiisi work" 
in any language your customer chcx>ses to use. 

When I finish with Interface Builder (and I might reverse the 
prcK css and play with Interface Builder first Ixx'ause it's 
sometimes more productive) I tell l^rojeclBuilder to comi)ile the 
app. t1l select ‘‘dchug” first if the app is laige or fm trying 
something fancy. If fm debugging, ProjectBuilder will build the 
app with all its nibs and then compile the new cla,sses wiili 
ebbugging extensions, lill then drop me into gdb (a debugger) 
with the app loaded, where ifs up to me to debug. There are 
various other debugging tools available under OPKNSTHP that 
allow me to examine the apfi's messaging, memory usage, 
o[Ximiz;Uion, etc. Quite tiftcn if Tm really bamhcKizled 111 tell gdb 
to show me all the mes,saging faking place between objects. It's 
.something like watching your chiklren begin to talk. 

1 haveiTl yet discussed Postscript wraps or the cool 
proces.s of trying out your Postscript code in Yap.app (there’s 
a server running tn ihe os, so wliy mil?) l>efore it gt>es into 
your [iroject. ProjectBuilder knows about wraps and various 
other resources too, so ifs an extremely useful kmjI for 
managing the process of creating a large application. Let's take 
a l(K>k at wraps and Display Postscript in general, 


DiSPIjW POSTSCIUPT 

Display Postscript (DPS) did not exist wlien NeXT first got 
logedier w ith Adobe to design a common language for writing 
to the screen and the printer. TTie general idea was to achieve 
true WYSIWYG by using the .same code to descrilK* both, and 
so DPS was Ixjrn. Steve Jobs wmed poetic alxmt XWindows 
while dc.scnbing why NeXF had chosen DPS over XII; he 
called X “brain damaged"', li is true that like many 
groundbreaking efforts, X became a little outmoded, and DPS 
is an elegant system. DPS is, however, imperfect in the context 
of the new age of nnultimedia, .so we'll pniliahly see niany 
additions to DPS over the next few years. 

De|xmding on your program’s performance needs, there are 
vaiious methods available for adding Display Po.sLs<Tipi to your 
prcjgrams. Note that mtxst progniiiis use very little DPS, and 
unles^s you’re designing a drawing application you probably 
w^in't have to learn much. "Ibat .said, playing with PosLsciipi 
interactively can be somewhat addictive, like fcxiling with turtle 
graphics and Logo if you’re old enough to remember. You may 
choose to spend more time with it ilian is absolutely necessary, 
and if you do, the printiples are life sjime. 

You may or may not know that PtKscript Is a stack-based client- 
stwer page description system. Your program is the client, and the 
.server is effectively either the .sen-va t ir the f>iinLer, In theory it would 
l>e nice to write code that worked on iioth semen and printer; in 
[iractice you cati’t lely on all printei^ being level II PasiscTipt- 
compatible, so you may have to rewrite small .scctioas of your 
display ctxJe for safe printing if you want to use Level 11 featuies. 

There are three basic mellUKls \hr using Display PosLscripC 
operator functions, wraps and user jxuhs, in descending order 
of iheir execution limes. 0[>erator functions are simplest, and 
you’ll use them wlien you w-ant to make a quick call to the 
serv^er for a single fiincrion. Here's an example of a common 
combination of commands in Postscript, a “moveto" command 
followed by a iineto" command. ‘Ibey create what is known in 
Postscript as a “path, and they're* followed by an instruction to 
“.siroke” the path, or fill it with ink. 

to to movcito 

50 50 llneLo 
stroke 

As mentioned, one of the really fun parts of OPENSTEP is 
gelling into Yap (Yei Another Postscript prtxessor) and playing 
with Postscript interactively. Some time ago 1 ported Rattle Zone 
to NEXiyPEP, and I threw the entire opening screen into Yap to 
lest it. 1 then movetJ elements of it around until I was happy 
with die way die screen ltx>ked. It was so much fun it alnifwt 
made op for the rest of rhe porting pr<K:ess. 

You can include ilicse in.si met ions in your code by u-sing 
PS operator fynctions. OPENSTEP has two PS Itbniry functions 
for every^ PS operator, one for drawing in a defauli coniexi and 
one that allows you to si>ecify the context. Here's the 
et|uivalenL of whaPs above, using the PS operator funaions in 
psops.h, which draw in a default context: 
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PSinovetodOp 10): 
PSiineto{50.50) : 
PSBtroke; 


Now youVc seen the origimil Postscript and tlic way you can 
implement it using single operator fiinaions. As you can see* it is 
causy 1<> convert any Hostscri[>t calls into operaUM' Function calls 
and insert them into your program* 'Fite problem wiU) doing thai 
is that each one of litc*sc calls is a .separate mess;ige to the server 
If you're calling one function occa.sionally, you're sending one 
message to tlic server ocatsionally, whicit is as gtKnl as you're 
going CO get. For monc' iFian one line of Postscript, however, you'd 
do better to package your PasLsedpt into a "wrap”. 

A w'rap packages your calls into a C function library that 
ProjectlJuilder cm l)e lold to include at compile time. You'd write 
a text file with the following in it: 

dfifiiiepsP SWDefs () 

/HI \% XI Y 1 X Y 
woveto 
lineto 
J bind def 
endps 

defineps muitliine(float datafac] ; int sc: Ihl len|thj 
data. 

1 1 length ML for 
endps 


Drop this into ProjeciBuilder* wliich will tull a program 
called “pswraf)”, to turn the File into a Friendly, cminenily 
readable and efficient package thai looks like this: 


/" ./5vi«/c_gpr.t; grncmed trom c_gpr.ps5w 
by tioix pswmpVr009 WedApr 19 t7;50;2i PDT 1989 7 
^include (dpsollent/dpsfriondii.h> 

#include <atring*b> 
ffline 1 “cftpr. 
ffllne iO ■■ . 7 sytn/c;_gpr*c" 
void PSynefst void } 
i 


typedef struct ( 
unsigned char tokenType; 
unsigned char topLevelCount; 
unsigned short nBytes: 
DPSBinObjGenertc objO; 
OFSBinObJGf!nertc objl: 
DPSBinObjneneric obj2: 
DPSBinObjGcneric obj3; 
DPSRlnObjGenerlc 0bj4: 

DPS BinObj Ce ne ric ob j 5: 
char obj6i2j : 
i _dpsQ: 

static const dpsQ „dpsF ^ ( 


DPS.DEF.TOKEirrYPR. 4. i4. 
t BPS LITERAL I npS_>iAMK. 0 . 


2* 48LrML7 


IDPS_EXEC 

mns^xEc 

IQPS_EXEC 
fDPS_EXEC 
(DPS_EXEC 


DPS_ARRAY, 0. 2, 321* 

DPS_tJAME* 0 * DPSSYSNAME* 14 J * rbindV 

DPS^fJAME* 0. DPSSYSNAMF.* 511* rdff7 

DPS^NAME* 0, DPSSYSaAMF.*l07L TmovcloV 

BPS_MME* 0, DPSSYSNAMEp 991* riindo 7 




1; /•_dpsQ 7 

regieter DPSContejit _dpaCurCtxt “ DFSPrlvCurrentContejitO : 
char pad[ 5 l; 

DPSBinObjSQ^Write{_dpsCurCtxt*(char ’) A_dpsF,54); 
if (0) ‘pad - 0; /* quiets wmpikr warninf«> 7 

I 

#line / "capr.psw** 

#line 43 "./syiii/c gpr*c" 

void multiline(const floet daLa[], Int x* Int length) 
i 


typedef struct I 
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SBriOUS development tools 

for.., • Object Oriented programmers 

• Cross-platform developers 

* Help and Multimedia authors 


* J V V 1 j ! 

The solution for porting 
Mac applications 
to Windows saves,,. 


Time 


Get to Windows In 1/3 to 172 
tOe ti/ne 


Money Leverage your existing tnvem- 
ment In Mac source code 


Code 


Support for PowerPlanl, TCI, 
MacApp and Systein 7 

Heads One sal of source means no 
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Altura Software, (nc 
510 Lighthouse Ave. Suite 5 
Pacific Grove, CA 93950 


Voice: (408)655^8005 
Fax: (408)655-9663 
Web: http://www.altura.com 


unsigned char tokeiiTypf: 
unsigned char topLeveiOountt 
unsigned short nBytes; 

DPSBfnObjGenerlc obiOi 
DPSHlnOhjOeneric objl: 

DPSBlnObjGenerif obj2i 
DFSiJinObjGenerlc obJI; 

DPSBinObjGcnerlc oh]4: 

DPSBlnObjCeneric objii ; 

> ^dpsQ: 

typedef struct I 
char obj6[2 : 

J _dpf5Ql; 

stBTlc const dpsQ dpsStat = I 
I}f5_nKF_TOKFJ^TYFE. b, 54. 

IUl'S_LITERA!. nPfi_ARRAY* 0, 0. 481. T panunjv^iT|:dm 7 
IDHS^LITEKAI. D['S_TNT. 0. 0. If. 

IDPS^LITERAL Dt»S_iNT. 0. 0. I|. 

IDPS.LITERAL DPS_1NT* 0. 0, 0). /* punim:length 7 

I DPS EXEC|DPS_NAME. 0, 2, 48], r Ml 7 

[DPS EXEC|dPS„NAME. 0. DPSSYSNAMi;, /2I . (TfnrV 


r V 

sLfUir rntifit 


ripfiQl dpsFi ^ I 


It /*^dpsQl7 
_dpsQ _dpsF; /* iiaai ropy 7 

register OPSConteJct ^dpsCurCtat ^ RPKPr ivCurrentContext(): 
char padi3jj 

register OPSBlnObjRec •JpsP = (DPSainObjRer ”)A dpsF.objO: 
register int dps^offset ^ 48’ 

_dpnF “ dpnStatj r ttssign Liuiuiiuik variahk 7 
_dpsF [Oj Jengtb * x: 

_dpsP[3],val.intcgnrVal = length- 
_dpsPlO), vul .atrayVal ^ _dpi5_of fset; 

_dps_oit8et +“ * ‘ jiizeoT ((JPSHlnDh jCeneric) : 

_dpsPl4j,val.stringVal = _dps_affset; 
dps offfiet 2: 

_dpsF,nByr.es - _dps_citt’sei+4; 

DPSR 1 nObjSeqWrite( dpsCurCtKl, (char ') !r_dpsF,523 : 


DPSWriteTypedObjectArrayC dpsCurCtxt. 

dps_ttloal. (char *)dafa* x): 

DPSWriteStringChatiJ(_dpsCurCtxt, (char “) 4 .dpsF1.2): 
if (D) ‘pad = 0: /* ^juicts compacr warnings 7 

1 

#1 Ine 12 **CL gpr.psw“ 

A.s you t'an sti'c, iL\s ejsicr to work In Fost.scripi and Ici 
ProifCtBuilder or pswrap do the work for you. lt‘^J also not a 
good idea to kx>k too often at the Hies tliat pswrap generates, 
lYecuise yoiili lx:gin losing sleep. 

There's a third way to interact with the DPS server, and Uiai\s 
witli user paths. A user patlt is a way t>f packaging up a buncli 
of Postscript and translating it beforehand for the server. Ytni can 
go even further by telling the server to store it in a user 
diaionary. 'Itiat way you can nuike one call to the server, 
perhaps to supply argumenLs, and you minimize your program's 
messaging overhead. Tlie technique is availal)lc when you need 
it, hiii from experience 1 can tell you that it’s easier to use wmps 
and then gf^ back and optimize where necessary with user paths. 
User paths are sonietitnes not very easy to tiehug. 

For the most part whentwer ytui irse PasLscripi, youll be 
lira wing in a *’View'' oi>jeet. a (lart of the Application Kit tliat 
mainiains its own slate for Po.stsc’ript optraikms. let's gt) kick for a 
Uxik at Interfacelhiilder and the Appkit and see why 
InteriaceBuilder plays such a large (Xiri in OPF.NSTl’P programming. 

lN'lliRFAt:i= BuiLDlitt 

On the surface interfacelkiitdcr looks essentially just like 
any interface builder. What it's doing underneath is far more rich 
and, in the end. far more useful \n the programmer, 
InterhiceHiulder allows you U) assemble all of the elements of 
your progiam and lest theiib hi some cast*s without even 
compiling the progi-am. You do this by grabbing objects off a 
palette and placing them where you want tliem. You can use 
almost any ol^ject in the Appliaition Kit, which is an extremely 
rich source of material, or you can also make up palettes of your 
own objects and drop them into Interfatvbnilder. 

A side IxmtTii of using I liter face Builder is that much of 
your program will aLitomalically cam form to the OPENSTEP 
UvSer inteiface standards. Inieiiat*eBulkier dtjcsn'l limit you to 
creating applications. You can create inndules as well, for use 
in taller apps. After you're done bringing in the various 
elemenl.s of your prognim, Inierfacelkiikler allows you to 
define the relationships Ihcse eleinenis will use to w^ork 
logelher. When youVe finished, you can test your afiplkation 
without compiling it from wit hin Inierfacrlhiiklcr, if a program 
works in InterfacenuiklcT, il usually works after it's been 
compiled. Sometimes you 11 even find yourself writing 
programs that never even run outsitle of Inierfaceliuilder. 

There are three major parts of InieifaceBuilder other than 
the area in the middle of the screen where you assemble your 
apps. The first is the file wundow (Figure 1), where all the 
differem part.s of your app are kept, including the parts that 
have no visual ifitcrface. As you add pieces to your 
apjdication you'll see icons for each instance appear in the file 
window. You on also instantiate your owm objects a.s you 
write code for them and they will appear here. 
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NeoAccess'^ displays electrifying performance—up to While others promise cross-platform - NeoAccess For information and Customer Service: 

ten times that of the competition. Behind Its elegant delivers. NeoAccess is a set of C++ classes designed for I T A A' - 2 b - ^ i 7 

programming interface is a fully optimized relational use with popular compilers and frameworks on Windows', 

query engine built for speed. It also has an object cache Macintosh 7 and Unk' platforms. Thousands of developers, ^ I * ' 

with automatic garbage collection so your applications Including America Online® and Claris*, have already H 60 ' 10§I C 

can run in a much smaller memory footprint than you found that NeoAccess enabled them to build fast, powerful NeoLosk Systems Inc 

ever imagined possible. And NeoAccess has no runtime internet applications In record time. That's why there are St.. Suite iz, Berkeley CA 94710 

fees so you pay one affordable price no matter how many more NeoAccess based applications on end-user v. 510.524.5897 1 510,524.4501 

copies of you r application you use or sell. machines than any other object database backend, rtEabgkQneotogic.com 



Figutv I* The FUe VC^indow amtaim all the 
pieces of {4u applicalum. 

The file window kcc'[xs intck of .sounds, iinuifcs. and 
infomialum alxuit ihc differeni cla,s,scs availal>k* to you a.s wolf 
You can use the file window\s class browser to hrowse !llrouJ^h 
the cla.s.ses for a paitkular class. The class browser will allow 
you to parse new classes into InierraceHuilder for use witli the 
other objects. You can also subclass existing classes in the hie 
window, and InicrfaceBuilder will write skeleton code for your 
new suIkIuss, including any action methods or outlets 
(pointers to other objects) your syl>elass niight have. You can 
add these action methods and outlets in the lns[)eLior window. 
Inspector windows are one of I he most inipoitant user 
interface innovations in OPHNSll-P. and a number of MacOS 
and Windows programs have begun using iheui. EH,sentially an 


nspet tor garhers all the iiniKHtant information about an object 
n one ftlaee. Interface Builder makes fundamental use of 
nspeetors in a most aitful manner. 



figure 2. An fnier/aceBuilcicr Aitrihutes impectoruinciow 

Figure 2 shows an InterraceBiiiider Aifrihntes iaspeeTor for 
a hctUious button in a fictitious application. Its what you'd see if 
you selectcxl the Imtton in lite same manner as selecting a line in 
a drawing program, llie AUril)LiLes inspector ailow'^s you to 
cliange llic Lille of the button instance, tlie icon il displays, the 
.sound it makes, w'hui kind of button it Ls (moincnUiry push, 
pushOn/piishOff, etc,), and various oiht*r attributes. You can 
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’...theprogram (ScriptDebug^t] 
is a solid performer, and its support 
for hrge fk sies, helfM 
Oictirmry mndow, superb scripting 


mtdce it a my good choice .' 

Avi ft{ip|X)por 1 and Ed Allen 
AiarHff A Magazine 


Script f>cbiingi.T iJi a powerful 
aiiil flexible AppleScripi™ auifi<}fltig 
tool duu lets nt^vke md ^^oned 
script writers get the most from 
.■\pplrtScrjpt, By combining an 
easy iiFUse inteitice with extfuswe 
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writing faster and easier than 
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Script Debugger, recenlly 
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Macdser (UK edition), oHers: 

M Na 32K limit on uiipts 
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Web site: hitpi/Avww laleiiightmcorn 

Late Night kthvore Lid. 
Voke (604) 9Z9 SS78 
Fax (&I14)?29 4961 
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ciLher S|:)ecify soimds or icons by typing their names into the 
inspt^ctor or yon can drop tiicni on to the liiitton and they’ll 
appear here. InierlaceBuilderis Inspector Window carries all the 
imjxMant information about an indiv idual object. 

in addition to aiiributes youll see other coniiiion elements 
such as details on the object s connectiotis to other objecLs 
(messages it might receive or send, and to nr frf)m wlioni), liie 
object’s size in various dimensions, or help attachments to an 
interface element. In short, the Inspector Window' contains detail, 
List but not least is the Palette Window, It’s ilie most intuitive 
window to use, IxrcaLuse you simply dmg objects ra)m the palette 
lo the application window^ or panel in w liich they shouki reside. 
You can drag Window and Panel objects, too. 



figure S* MerJaedMiders Paiknte mndou-. 


Wlien you’ve finished dragging, browsing, parsing, clicking 
and typing, it's time to finish your application by drawing 
connections between all tlie different objects* When ymi ve finished, 
your ol>jeas will be al^le U> send messages to one anoilier, and you 
can test them l)y seleaing “Test Interfate" in ifie menu, Wlien you're 
all finislicd, click “Save” and InterfaceBuilder will archive the objeas 
for you in a nib file. Tlie nib contains most of the inlbnnation about 
a program, and as you can see, anything in llie nib Is machine non- 
spetafic. Tliat's why apps written in OPENSTEP are easily delivered 
acToss processor archiieaua^s* InterfaceBuilder is very cool, 

OBJFCITVE-C, alias OBJECTIVH-C++ 

Fear not Objetrtive-C. Yes, it is another programming 
language. It will, Ixmever, give you a comix^iitive advantage in 
development that you probably don’t l>elieve possible right now. 
It's also easy to learn, and before you mumble to yourself that 
you've heard that Ix^fore, let’s take a lcx>k. 

Objective-C was designed by Brad Cox, Smalltalk guru and 
the author of “Objett-Orienied Programining, An Evolutionary 
Approach”, a seminal work in OOP circlets. He chose to make 
C^bjeciivc“C a mix l:>eTween Smalluilk and C, ^itiempting to keep 
the best feaaires of both. Objective-C takes dynamic typing and 
dynamic binding from Smalltalk. Within a cias.s, however, it 
preserves ilic conciseneSrS anti efficiency of C. 

On the surface, there arc basically three differences between 
Objeaive-C and C: 

1. Objective-C has a type called "id" tfiai functions as a ptrinlcr 
to a generic ol>ject. 

2. id is the default return type, rather than an int. 

3. Objeclivc-C has a messaging syntax for calling a method within 
an object. It uses embedded arguments, and it l<x>ks like 

[object method] 

Here’.s an example of a message to a hypothetical t>l>jcct called 

gtaphObject to plot a point at location (x,y,z) with color graphCtolor; 

[j^traphObject plotXAtix andYAtiy aadZAtiss 
withColorigraphColor]; 

The syntax may seem strange with the embedded 
arguments thrown in, but it’s not alt that confusing* The method 
could be prototyped as 

’ (void) piotXAt: (float) x 
andYAt: tflowl) y 
andZAt: (float) 4 
wlthCalor: (float) color: 

Tlic idea is that the format us more cx>nducive to designing 
(vadablc code. You ran give your methf.xLs senience-Iike names 
like the one aixjvc* I've lieen able to return to cxxle 1 haven’t .seen 
for over a year and l:)egin w'hcie I left off. 1 have never found 
anotiier programming language that allows an rase of ovemll 
maintainability that compares to that tif Objective-C* Syntax, 
liowever, may make Ol^jeaive-C maintainable, but that isn’t what 
make.s it powerful What makes it powerful is its featyre*s, and my 
favorite feiiture*s of Objective-C are dynamic typing and binding. 
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The utility of a generic [pointer to an object is that it gives 
the prograiniiicT tlie ability to ]'}o[nl to an ol>jec:t without knowitig 
what it is beforehand- Objettive-C has reflection and discovery, 
so I can point to an unknown oirject and ask it to descrtlx^ iist'lf 
and whcilier it knows how to do certain things. 

By using id to point to the object rather than siaLit'ally typing 
it at runtime as an Ql:)ject of class X {you can do that kk)), I’m 
telling my program not to wony aixjut what the object is yet. Tlic 
object will be bound at rtintime, and pemiiling me to choose 
wliat object I want during llic program's execution instead of 
being forced U) predict it at the link stage. The object J bind with 
at runtime could be written years after the calling t'ode, and the 
calling program wouldn’t know the difference. 

Dynamic binding, dynamic typing and objed discovery and 
reflection allow me to utilize taie polymorpliism. I might have 
several different code libraries containing classes that all fiave the 
same names but do different things. I might have a metliod call 
in a class, for instance, that looks like 

[storageObject irvser iRetord r record 1 ; 

One application might call for the storage rnethtxl to lx? a 
hashiable. Another application might be best suited witfi a slack, 
Tile same class t'ould be used for without any rewriting, 
bec'aiise my stack clas,s and hashtable class understand the Siime 
inctlKxis. All of this flexibility tnight he hard to manage, except 
that Objective-C allows me to declare formal protocols for classes 
to obey. A ckiss declaration in Ob|ective-C looks like 

^interface MovUpThcUorldClass : Object 

Ihe same class declaration with an instruction to the 
compiler to make sure that lijc cla,ss foUows a fomial prottxiol 
looks like 

Sinterface BlowUpThaWorldClasa : Object C fllowsUpThings. 
CannotBeStopped > 

Protocols are truly powerful because they allow the 
programmer to easily take advantage of extreme 
polymorphism. A class can send the same message to classes of 
entirely different inheritance subtrees, which leads us to 
inheritance and scope coherency. 

Scope t:oherency is not an issue with Objective-C; it uses 
a single inheritanc'e model If it’s necessary to inherit methods 
of a wildly disparate nature that don’t fit into a single 
inlieritance model easily (and my experience has been dial this 
case is rare), I can group methcxls into Categories. Categories 
aren't only good for char purpose, however; they're an 
extremely powerful tool wiUi many uses. 

Using a aitegory, 1 can add methods to a class witlioui 
having its source exxie- Effectively, 1 can extend clas,se.s that are 
already running, and all sulx;las.se.s of those classes will inherit 
the abilities you added transparently. 

I can also group like methods in a very large class into 
varkms categories. That ability nets me incremental 
compilation, better locality of reference, configurability of 
classes for special needs, and a way to divide up a large class 
among multiple developers. 



Biit, Inc* 

Fast affordable memory allocation library and 
debugging tool for Macintosh applications 
written in Metrowerks C/C++ 

1 2 -1oo times bister than coinpiler allocators 

debugging api for finding memory errors 

external debugging tool to track memory 
usage, display errors and control the allocator 
while yourappljcation runs 

$99 

See our website at http://www.bi it com for more 
information and ordering instructions 


With OPKNS'FEP, NeXT broughi many of the best features of 
C++ into ObjecUve-C, renaming the language Ohjective-C++. The 
end result is m exlretnely powerful marriage, sort of like C++ 
W'itli a clean syntax and much-improved maintainability . 

Some members of the Java team originally worked for 
NeXl', and Java resembles Objective-C far more closely on a 
stmctLinil level than it does C++. If ytju've looked into Java, and 
liked it, you’ll lt)ve Objective-C. 

FOLIfVDATlON Kl l 

l>evelo|>iiieni under NEXl’STEF lias always basically lieen 
AppKit + Objective-C + Dl’S, which somehow' magically added 
up to more than the sum of their pans. Over the years, tliough, 
there were many NKKISTEP develo|xjrs who argued that 
NFXl'S'l'EP w^as somcliow impure in a few ways, ll lacked 
garirage t*ollection. It had no string objeas. It didn't sup|K)rt 
Unicode. Many of the problems we discussed were along the 
lines of the [Derennial “wJiy should the user tiirow' the disk away 
to eject it?" discussion in the Mac w'orld, 

Witli OFENSTHP, NeXF had a chance to redo some things 
in a better fasMon. tJnfommately, they were still under time 
pressure, wJiich meant that some of the changes weren't 
optimal s<jluiion.s. Still, OPENSTEI* makes some good 
improvements on an already elegant foundation. NKXl'S'l'EP 
was the first step; OPENSTEP is die next step. 
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Foundation Kit brings some final polish to the Ol^HNSTEP 
development environment, h brings some basic utility classes, like 
NSArray, NSThread, and NSException. It brings teference counting. 
It brings tlniaxJe strings. It brings.., complexity. It brings slowness 
and bulk. Such is the price of pow'er and imturity. 

Mac developers are already familiar with Unicode. Foundation 
Kit olefines tlie following enccHlings su[7[x>rted by NSString classes: 


Encoding: Purpose: 

NSASCII.SrringKnocKling fw 7 lwt ASCII encoding 8-tiii dam 

NSFIJCSiringEncoding.for Japanese Lcxi 

NSISOSlringliritxxling .for ISO Laltn 1 

NSNIiXrSIT'PScringErcoding . . fiir 8 I nr ASOl tmeoding willi some fxtfr&HJiis 
NShbnljtissyASCDSliingFjrKt^ .. (iimidtncdl 
NSSymlJolSiriiigtiKXxIing.(unckftnccl) 

NSUniO KlcStriogF^cocIing . . . st^ntUrd Unic’txfc encoding for string n^nctts 

NSUTFStringEflCoding .. .8-bir Lintctxic for transmission Ijy ASCII httsctl .systems 


tf you pnKiiicc software that must be localii^ed, you1l have 
plenty of fun with these. 'Tliere's an encoding for every purjxisc. 
Support for Uniaxie is inijxjitant, but what's arguai>ly an even 
bigger addition widi Foundation Ki! is tliat it brings garbage 
collec tion and standardized exccpikm handling, 

NeXT's so I lit ton to garbage coHectiem is reference 
counting — possibly not the most elegant solution they could 
have chosen, but it's robust and it works. Basically the 
Application object for each ap])lication keeps an autorelease 
pool for storing references to objects. When an object is 
allocated or copied from another ot>jecU it is given a reference 
count of I, Every message from another object to retain an 
ol^ject incremenis the reference count; every me.ssage to 
“autorelea.se" the object decrements it. When the reference 
count reaches 0, the nutoreleasc ptx>l rc!e;tse.s the (>hteci. 

To understand a little bit better, imagine that you have an 
object called spy, The spy ohjeci has ilie ability to conccxri 
fantasLic schemes to take ttver liic world. 

So if another object, say, the Control object, messages spy 
witli a message to concoct a new scheme: 

[spy concoctSchemel: 

then spy might do something like 

- (void) concoctScheme 
i 

[cyrrentScheme DUtorelease]: 

cur rent Scheme ^ [ { Scheme alloc | inli ] : 

return; 

1 


Tlie rule is that if you create an object, you are res[x>nsilile 
for releasing it. By .sending ctirrentScheme an autorelea,se 
messiige before reluming it, spy is declaring tliat currentScheme 
dexfs n<n need to exist teyond the current sco|>e. By the way, the 
alxive example afst) illustrates nesting of messages, wliich works 
in a similar way to ne.stmg function calls. 

Wiiat if the spy had alre.ady passed the durrentScheme ohjeci 
to iLs trusted partner, dirlyCounterSpy, and then subsecjuently sent 



Powerful enough to 
handle all your bug 
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Affonlahle enough to 
put on everyone's 
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the uuloreieaj^* niessuge to currentScheme as above? Kveniually 
I he other object might mes,s;ige the old currentScheme, which has 
probably long since been auto-re leased, and the dirtyCounterSpy 
objed would crash hard, taking Control and spy and all the other 
objects in the secret espionage program with it. 

'fhe way to solve that would Ix^ for dirtyCounterSpy to send the 
()kler currentScheme deject a retain mes,sage. Sending a netain 
messitge incamients the older currentScheme's refemnc'e Liount in 
the autoadease fXK)l. Hiat way when ihe spy d)jea .sends an 
“autoadease" message to currentScheme, the reference couni dro[>s 
only io I insteail of 0. llie dirtyCounterSpy objext am now keep the 
cunrentScheme otiject evon ilimigh the objet i lias Ixajn mleased by 
tlie spy object, and, in tact, wen if the spy object i.H destaiyed the 
dirtyCounterSpy objm am use “aiain" to keep currentScheme. 

1 hope fhi,s tlitiy lesson in in the affairs of espionage has 
brielly tlhisirated reference conn ling, and |xahaps in other, more 
exciting ways it's illustrated a little of the pow'er of OFEMSTER 
There's tjuite a bit more to Ftxmdation Kit, incxstly in the area of 
abstraction, tliat Ls somewhat IxyontI the scope of this article. 
You have what you need, however, to grali a copy of Rliapsudy 
a nd create tha i k 1 11 e r a pf). Kl 

visit MacTech Magazine’s Web site! 

http://www.mactech.conn 
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The sporty new intetface in MacA&D d.OenMes designers to click to properties, dictionary 
details t integrated specijlcations, code or related requirements for any selected diagram object. 

See htlp://www.excelsoiiwarc.a>ni lor tiiore details. 


Software Engineering 
Made Easy! 

MacA&D aiid WitiA&D simpliiy 
system analysis* track requirements 
specifications, aulomalc pt>pular 
modeling techniques and generate code 
from your design. 'Iliroughout the 
process, extensive verification reports 
catch enx>rs early to help you produce a 
quality product 

Powerful capabilities arc just one 
advantage. Years of innovation have 
made these producLs easy to use and 
each includes extensive cxiunples and 
tutorials* MacA&D and WinA&.l> share 
docurnetits so your project team can use 
Macintosh, Solaris* HP-UX or Windows 
95/NT computers. Select from OM'P, 
Booch* Shlaer/Mellor, Coad/Yomdon, 
Fusion or Jacobson methods or pick and 
mix the best of each. 

9 Structured Analysis & TJesigit 
^ Object-Oriented Analysis & Design 
9 Data, State and Task Modeling 
9 Integrated Code Editing & Browsmg 
9 Multi-User Dictionary 
^ RequiremenLsAJse Cases 
9 Generates C* C++, Delphi, SQI^ etc* 


Powerful Tools 
For Software Design 


TA''.-: ' ' 





{■jink 


tfhljjiihiniHi if <Uirm 





See our web site or dmp us an email 
to receive detailed technical brochures 
for Mac A&D or Win A&D. Check out the 
new MacTranslaktr and Win’I'ranslator 
products to generate design documents 
automatically from existing source code. 


[ EXiel SnflwBlf 


MacA&D 




I '' £xci-l r 




WinA&D 


Excel Software 

515 - 752-5359 


MacA&D 

for Macintosh, Solaris and HP-UX 


WiiUl&D 

for Windows 95/NT 


Cl 1997 Exwl Software. MacA&D, Mac Analyst* 
MacTranslator* WinA&D and WinTranslator are 
Lradenwks of F.xce! S oflware. Ph. 515-752-5 359* 
Fax 515-752-2435. Email info^exEielstjUware.oom. 
Webi hup: //w ww .eKcelsuflware com 





















































































hy Michael Rutman, independent consultant 


Building an OPENSTEP Application 


Is it really as easy to 
program in OPENSTEP 
as they say? 


OPENSTEP ANi> NEXTSTEP 

In 1983, Steve Jobs left Apple mil 
formed NeX'l, Ke found the latest 
technologies and l)n)yglu togetlier a team of 
develo|x:rs to tiiin tlie newt^a theories into 
realities, 'lb verily the new technologie.s, 
during dc'Vclof>men[ Steve would often stop 
deveio[^iiient and have the entire team use 
tine system they were creating. Sevenril 
existing apps wert* created during these day 
or week long kilcliens. Moie‘ importantly, 
each developer knew Ikjw^ the framework 
would lx* used. If developers imi a Ixircl 
time using an i object rluring a kitclien, liicy 
knew they had to iTework that Ql>jea, 

The system they created was called 
NEXTSTEl^ NEXTSTFJ^ has several layers, 
and each layer was state of the art in 1983. 
In the 12 years .since Steve picked these 
technologies, the state of the art may have 
moved, but not advanced. 

The underlying OS is a Mach mini- 
kemel running a ljnix eniulator. For pmetical 
puiposes, Mitch is a flavor of BSD UNix. 
However, the Mach mini-kernel offers 
programmers a rich set of Functionality 
l:>eyond what UNIX provides. Most of tlie 
ftinairmality of Mach is wrapped into the 
NEXTSTEP framework, m) pnigrammers gel 


the power and flexibility of Mach with the ease of use of NEXTSTEP 

Sitting on top of Mach is Display Postscript. Postscript, the 
language of printers, is a nice graphics language. NeXT and 
Adobe opliniixed Postscript for displaying on ihe screen and 
produced a speedy and powerful display system. NeXT's 
framework hides most of the Postscript, but if a programmer 
wants lo get into tlie guts, there are hooks, called pswraps, to 
work at the Postscript level. 

NEXTSTEP needed a language, and deckling on a 
language was difficult, in 1985, there w'ere a lot of rheoretical 
languages that claimed to be Ol^ject-Oriented, but few were in 
actual Li.sc, C-t-+ was not shipping, hut Ohjecrive-C was. 
FunhcTnKJie, Obieciive-C was a much easier language to Irarn 
and LI.SC. UnfortunaLcly, the rest of the industry went with C++. 
NeXT responded by adding C++ to Objective-C. Today, under 
OPENSTEP, programmers can use OI>jecfive-C, Java and C++. 
However, the framework is still based on Ol>jeelive-C, so 
learning Objeclive-C will be important. 

Using Objective-C, NeXT created the AppKit. 'I'he AppKit 
is a framework for creating applications. There are many 
frameworks for making applications today, hut the original 
AppKit is the easiest to use. In addition to the AppKit, NeX't 
expanded with the Musk: Kit, Foundation Kit, and EOF 
(Database Kit), With these kits, a developer can create full 
featured applications very^ quickly. 

The la.sl layer of NEXTSTEP i.s the tools. NeXT has 
implemented a very nice suite of developer tools, NeXT has 
separate applications for each pan of development, bin the 
applications c{jmmunicale with eacli oUkt providing an 
integmted environment. Source files are edited in Edit.app, 
Projects are maintained and compiled in ProjectBuilder.app, 
Interface.s are created and edited in InterfaceBuilder.app, and 
debugging is done with GDB from Edit.app, In addition, tliere 
are command line aiternative.s for any of the.se GDI applications. 
Each of these applications work with the command line 


Michael Rutman is a software developer with experience developing for several platforms, including Macintosh, NEXTSTEP, 
Newaon, Pilot, and Windows NT. While working at Software Ventures, he lead tlie development of Snatcher and MicjoPhone 
Pro for NtDCTSTEP. lie also worked on the MicroPhone Pre^ for Macintosh product line. He now works as an tnrlependent 
consukiml on a variety of projtxts including encryption, compilers, web based add-rotation software, and ship stevedoring. 'Jo 
contact Michael Rutman send mail lo moosc@manicmoase.com. 
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prQgnim,s, ho tKHwccn thtf two Ls painless. I^ersonalfy, I 

sfx*nd mast of my time in the GUI applications, l^ut 1 know other 
programmers who Lise emaes exclusively. 

Now with NBXTSTEP defined, what is OPENS'rHP? 
OPRNSTEP is tile same as NEXl^lRP, but does not include the 
development tools or the OS. OI’RNSTEF will run under any OS, 
and any development ux>Ls can lx: used to create OPENS'I KP 
applicatioas. At least that is the tlieory — we will see what Apple 
decides for Rhapsody. At the time of writing this article, it looks 
like Apple's Rhapsfxly will lx- close to NEXTSTEP. 

OPENSTEP comes with tutorials to explain exactly how to 
use the development tools, so I will gloss over tfie details where 
they are straight-forw'ard. I will create a networked lunch 
application using NEXTSTEP 3.3* w^hich w^ill be similar to 
OPENSTEP. but not quite. Each person on die network will Ix’ 
able to say where they want to cat, and everyone else running 
the application will sec their choices. Tn general, development 
under NEXTSTEP is identical to development untier OPENSTEP, 

Creating an Appucation 

.All OPENSTEP applications ,staft w\ih ProjectHuilder.api), 
After launching Project Bui lder.app, we create a new application 
called "lunch.*" ProjcctBuilder also lets you create bundles, 
palettes, tools, libraries, and more. Starting sot*n:e files and 
interfaces are automatically cTcated and placed in ProjcctBuilder. 
Figure 1 shtiws Project Builder with a new' application. Double¬ 
clicking lunciLnib will open the interface file for the lunch 
applic’ation in InterfaceBuikler 



Figure L 

InterfaceBuilder creates and edits the user interfaces for 
OPENSTEP applications. The interfaces are stored in “nib” 
files. Buttons, windows, lists, and other Ui elements can be 
added to an application graphically* Some of these steps are 
hard to explain if you drmT have OPENSTEP in front of you, 
but once you have OPENSTEP, you will see that this is all 
straight-forward pointing and clicking. 

The lunch appljt:ation will contain a text field, a button, and 
a scrtilling LuneftView o!>jcct. The text field and button are already 
provided by InterfaceBuiler and can be dragged intt) the window' 
from the palette. The UinchVlew ofijecl Ls a placed by dragging a 
CusUanView and a^mitg it, InterfaceBuilder's menu item c:alled 
Group In Scroll View moves the ciistom view into a scroll view. 



The dtF 
Database 
System 


Fast, secure and 
eai^-to-use! 

dllf' ij? a high-perfoaivujqa, SQL database fincine supporting MPW' 
C/(U+, Symantec C/f>+, Meirowerki CocicIV^rfior (at! tbmpilcrs 
(jSK and nmive PPCl Separate veiiiions available for ustc with 
Hyp^frCard Xx, S'uperCiJrd Smalltalk Agents* Apple Media Ibol 
aad Piciorius Eiitrada! dtF h fully OpenDoc™ compatible. With iK 
iinfquc mreci miegration technology, dtF is fully contained in your 
application, there is no need for separate drivers, iNlis or background 
processes. Standalone applications built with dlF arc myalty-fiee. dtF 
is fully CD"ROMabla and has mexSest runtime Tequireiiienls, making it 
an idctil choice for Powerhook or Multimedia applications. dtF sup¬ 
ports cjoss-platform development on Windows 3.1J* 95* NT and OS/2 
with an identical API across alt platfonns. 


#1-4-17' The Relational 
wlA ULf Database System 

dtF Afiiedcas, Inc. 

19672 Stcvcn.s Creek Blvd.* Phoue: (800) DTF-1790 
Suite 128 Fait: (510)828-8755 

C'ltpcrti no, C A 95014. U SA I n lemet; d tF @ iiiterramp.com 

h rtp://w w w.Jiie lagroup. i lk.de 
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d importine) 

tf^ia Wide 


professional web page development tool 
Award winning spell checker 
Irue, continuously updated^ WYSIWYG preview 
I'ables (creating, editing, and 
Limited site management 
Forms 

Wa h^WMn xtM 

Text and styled text 
Add your own tags 
Very customi:£abie 
Preview with different browsers 
Includes two free upgrades 


MacUser, August 1996 




• Check/bdil/UjKlale all of your links on yonr sitn on seconds! 

• Upload pages and sites directly to the web 

• Work offline and then lei Site Weaver*^ synchronise your work laler 

• Lasy Mac i me dace for novices or lull lime professionals 

• Works with jusi alxml any graphics/pliig-in program, page cdiUid*' and 
web browser 


For the latest ordering information point your web browser to 
http://www.MiracleIne.com or call (315) 265-0930. 


rnierraccBuiklcr has an laspector window' forscUing aiiribuics on 
obje<-Ts. Tltc ln.s|X‘CLnr is umxJ to fine time the locnions of Lite 
controls, ‘ilie ins|xxtt>r also allows us to disable the Lat bulton. 
The resulting window- Is shown in Figure 2 . 



Figure 2. 

User Inte.rface Control 

The lunch ap]ilicalion uses two custoin ijhjects. 
Interfac'eHiukler allows custom objecLs tcj be created and 
automatically integrated into Pro|ectBujldeE When a nib is 


opened, a window tilled wilh the name of the nib appears in 
the lower left. Thin window lists all tlie non-graphical objeas 
in the nib File, as w-ell as the windows. Custom objecLs are 
created under the classes tag. 













I|!y « *v V i ^ j ;,5K 

is fJ'TSI«»- MalnMenjj ■;; 
' *. 


pi - kunchOblett . *. . My Window 




'^\m\ lunch.nib — 


..,mati ic /UsersAn o□ s e Aunch /Eng NshJpro j ^ 


i. 


Figure JL 

Every nib file is owned by an object, which is typically the 
object cneaieti just Ixidre ilit^ nib is kxided to [KX)k the nib into 
the application. 71iis objeci is rcpri?stmted by the l-ile's Owner 
icon in Figure 3, and can lx set in llie Inspeclon For lunch, nib, 
the File's Owner is an Application objed txcause tins is die 
.stalling nib. A subclass of ilie Application could be made the 
Mle's Owner, hut delgaiion works better. 

Some olijects, such as Window. Text, and Application, have 
h(Kjks built into tliem lo delegate functionality to other objecLs. 
We will create a custoin object lo act as our Application's 
delegate. Delegates mtxiify the ftincLionalily of core objects by 
implemenling methods. 'Ihey need only implement some of die 
methods. If a metliod is not implemented, tlien the core objeci 
will know not lo call it. Objective-C alktws runtime cliecking of 
vvhai routines are implememed, so delegates can be ver)^ light¬ 
weight ol^jecls, Tlie lamchOhjtxl is ilie delegare to both the 
A[>p!ic-ation and a test fiekf. 

Custom objects are creuletl by .selecting Classes from die 
tags. The low'er left window will now liKik like Figure 4. In die 
Ixatom of tlie window is a pull-down menu called Opentiions. 
Tills menu contains the operators used to create custom objects, 
'fhe subclass operator will cTcaU? a subclass of Object. I'he new' 
olijeci .starts with die name MyObjeci, but siuxikl lx changed to 
laincliOhject for this project. hunchObject will implement 
methods for controlling the nilfs custom interface ohjetis. 
Outlets in die l.uncliObject are required for tlie svindow, edit 
liullon. lunch view' and texi Held Create 4 oLitleis and name ihem 
window, lunchField. lunchView, and iunchButton. Also create an 
action called eat. 11ie unpaisc ojxTattjr will create a template, 
and puts the source files in Project Builder. Selecting die 
insianliate ofKrator will cre^ue :m instantx' of LunchOhjeci. 


36 


liUlLDlNO AN Ol'nN.S ntl* Al’CUCIAnON 


MAcTiitHMACiAZiNii • May 1997 













































Apple Developer University Has New Classes ^ 

• \Wiv updated our QuickTime VR traiiiir^ for version 2. ft 

• Our AppleScript class now includes creatin}* CGI applications for your 
Mac OS web server. 

• Neiv course: Propramminp jairaon the Macintosh 

• Mso note our neu> location in Soa/ob, Massachusetts 

Classroom 

(!licck uur wdxiite for compte <](.?<( ripti(n].s, .schedule and fees: ht[p://devwnrl<i.a|)|)le.aiin/du 
To retpsterrall • (800) 282-2732 (U.S.) • (800) 637-0029 ((jitiada) 

• (716) 871-6555 (OuLside U.S./Canadii) 


DEVELOPER 


% 


Self Paced IV'aining 

Virtual 'Ibttir for QuickTime VR, J79.95 (pan number KU17I77/A) 

And many other titles, lb order, call the Appfe Devetoper Cataiog at (800) 282-27.32 


Online *nraining 

Free online training b available on many popular topics. Sec Virtual Tutor for QuickTime VR 
UNIVERSITY at our website: htip://www.devwortd.apple.com/du in the online training area. 




Figure 4, 

Holding down chc ronirol key, dmg from the I’lle’s Owner 
field to ihc LunehObject. The inspector shows wlitti 
connections are possible* Selecting the delegate t)utlct and 
clicking OK in the Inspector lux>ks these objects together No 
code tihange is necessary to hook objects together. Dragging 
from tlie LuncliObject to the window, text field, custom view, 
and button allows us to stft ihe LyncliObjects outlets. To set the 
htittons action, drag from the button to the LunchOhjeti and set 
the targets aaion to lx? eat. 

To enable and disable (he Rat button dejxnding on if there 
is text in ihe text field, make the LunchObjea the delegate of the 


text held. (One objei:i can lx the delegate to many (>ther 
objecLs*) Drag fmtn the text field to the limchObjec:l to set tlie 
delegate. Another nice feature for iist-xs is to lx able to press 
return in the text field and have tlx F.at button hit, 'I'hLs is done 
by dntgging from the text field to the burton and selecting 
targelipeilormClick, Again, no cfxle changes are* necessary. 

Whenever text is changed, we must enabled or disal7le the 
button. The delegate methcKl that lx.st handles this is - 
textDidGelKeysiisEmpty, implemented in Listing 1. Tltis methcKl i.s 
called whenever the text field receives keys. For performance 
reastjns, it is not called each tmie a key is pressed, bui for our 
purfxxscs it wall work veiy well. 

Listing, 1: User Interface code 

UxitUdGef Keys : sender isEmpty: (BOOL) flag 
I 

UunctiBu L ton setF.nnbl ed: f f lagl ; 
return self: 

I 

Tile second custom object is our LunchView. LunchView 
is created very much like the LuncliObject, but it is a subclass 
of View, It has no outlets or actions, but is unpar.sed like 
LunchObject. Instead of instantiating a copy, we click die 
CustomView' we created earlier and use the inspector to set 
the custom view to lx our LunchView. 

Once the nib is saved, the user interface is done. 
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oiirServer - [renoteHub connectionForProxy]: 
[reraoteHub 

sctProtocolForProxy:@protocol {LtirvchServerHethods) J; 
isServer “ NO: 

1 

else 

I 

/pifk are first to bimch^ so wc ate the server 
ourServer = 

tllXConneclion registerRoot: self witbName: "Lunch: 
roiDOteiJub “ self: 

IsServer ^ YES; 

clientList ^ [iList alloc] inlij: 

1 

[ourServer reglstcrForlnvalldationNotificationsselfl; 
[ourServer runFroniAppKit] ; 

[reiBotcHub addClleni: self]: 

[self updateEveryone]: 

return self; 


' appWlllTennlfiate: sender 
t 

tremotcBub renioveCllent:selfl : 
return self: 

I 

- sendexlslnvalld;sender 

if ( sender I'” self ) 

I 

//server died, wc all ijave to go away 
remoteMub ^ nil; 

[ NXApp te rniinat e: se 1 f 1: 

1 

else if ( isServer J 

[self renioveCl ient:sender ]; 

1 f ( i sServet ) 

[seir updateEveryoneJ : 

return self; 

LiinchObject will act as Ixith server and clicnL Each 
1.11 ni'hobject checks die network for any other LimchObject> if it 
dtnrsirt find one, then it will register itself as the server. By 
checking the liosi *, we c hec'k a I! machines on the network. If we 
knew a server was running on one parti ail ar machine, then we 
could specify that miichine as the host. 

Registering self a.s the rrK>t object will c'ause this object to 
lx.* disirihiited over the network. The next LunchObjeet that runs 
will cheek tlie network, find the first LunchObjeet registered, 
and receive a proxy to the first LunchObjed. A proxy Is an 
ofijeca that pretencls to lx* another objec:t. Any ('alls to the proxy 
go through Mat:h messages to the real object. Tlie real r>bject can 
return any data it wants, inc^Iuding other objects. New abjeets 
t an lx* passed by copy or proxy. By default, the hrsi obfect will 
send a proxy to the second object. 

Once tile two .sides are communicating, the client tells the 
server about itself by asking the server to addClient on itself It 
is passing a proxy of itself to the server. If a client quits, then 
it will remove itself from the server. The connection is also set 
to understand the LunchServerMethods protocol to avoid 
round-trip calls when possible. 

Once die two sides are communicating, tliey niusl update ail 
the diems. Listing 3 fias the axle for adding and fenio\ing clients. 

//We will be a diem 


MkLinu,% 

Microkernel Linux for the Power Macintosh ^ 

Why wait for Rhapsody? Mkl Jnyx is a complete system, 
based on Linux 2 and the Mach 3 microkernel. It includes a 
complete software development system (gcc, gdb, perl,...), 
X11R6.3, and hundreds of other commands. Get MkLinux 
and start working right now with Mach, Objeedve-C, UNIX 
development tools, and more... 

MkLinux builds and runs most Intel-based Linux software. 

It works efficiently and reliably on a wide range of Power 
Macintosh platforms, with other ports on the way. MkLinux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer. If you want to 
get a jump start on Rhapsody, this is a great way to do itf 

Visit Apple's MkLinux web site (w^ww.mklinux.apple.com) 
and Prime Time Hreeware’s web site (www.ptf.com) to find 
out more about MkLinux and other fine freeware products. 

Prime Time Freeware info®ptf.com 

370 A Itair Way, #150 (408) 433-9662 

Sunnyvale, CA 94086 (408) 433-0727 fax 




NinwoRKiwi 

In Ohjeraive-C, run-time binding allows two objects with 
completely dilTca-ni inheriTences to implement the same method. 
However, this flexibility lias some costs. Kun-time lookups take 
slightly longer, the compiler cannot catch hud aills, and the caller 
has to wait to sc*e if the rec^eiver is going to resfiorid. Objeciive- 
C partially solve.s these prtiblenis by implementing protocols. A 
proUx'ol is a list of methcKls that objects must implement. Lhere 
is still a cost for run time knikups, but the compiler wall catch 
bad calls, and the caller cun know' tf a value will lx* returned. 
With networking, not having to w^ait for a response can make a 
big difference. Our LunchObjeet supports two proUxiols, 
LunchClieniMethods and LunchServerMethfxLs, 

Inter-Process communication is very easy under 
OPENSTEP. The firsi .step is forming a connection hetw^een 
two proces.ses, LunchOlijcet is the delegate of Application 
and gets an appDidinit call when the applicarion is done 
launching. Likewise, it gets an appWillTerminate call before the 
application quits. If a connection breaks, senderlsInvalid will 
be culled. These three routines are in Listing 2. 

Lfsiliig 2: Network connection 
tippUidlnit 'fiender 

remoteHub “ 

iNXConnecrJott cotinectToNaine:'‘Lunch** onHost; "•"I: 
if (remotpHub) 

[ 
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The npiber one AppleScript environment 



K f" * 

. I 


For professionals, 

:; for nouices, 

■: - for webmasters, 

. ::; ■ for solutions providers: 

. Always the most powerful, 
the most feature<-packed, 
and at the same time, 
the easiest to use. 

It's already the only tool that lets 
you watch local variables, trace 
variables, or change values and 
fix problems while stepping. 


idens the I 

There’s only one serious choice. 


e £1 d - 


And it just got better. 

Now, Scripter hits version 2.0, 


Handler debugging: 


Applet and CGI 
simulation: 


with still more 

Del)ug handlers without modifying your .scripts. 


unique features 


Interactively debug live interapplialion messages sent to a script application or AppleScript CGI from 

“ ■ ■ ■ nodify’ “■ 


Live editing: 


an applet, your Web server or FaceSpan 2.x. You won't have to me 
Debug script applit-aiions and CGLs in their normal environment. 


your Web pages or your CGIs. 



g Explore a graphical view of the class hierarchy of .scriptable applications. 

Construct generators; a,s.sociatcd terminology; search backward.s; faster searching; more 


navigation tools; 

g makeup of AppleScript strings; fast compile (without debugging): even morc-ea hanc ed trace log; and more. 

ScriptRa.se, .sejraraiely $59, is now included with Scripter. Use it to store your data 

(frquemly used values, scripts, text, pictures. HTM1„ headers, file refcrcncct^^d.share dieni neitwm^ 

S«:ripts. Mkage ScriptRase tlirertly from Scripter. 


We designed Scripter for 
produaivity anti iiser-friendlinesi. 
People come to us for Scripier’s 
industrial-strength debugger, but 
wliai really impresses them is the 
speed and case at which Scripter 
allows diem to work. It’s been 
used to build major corporate 
process automation .sy.stems, 
Scripter offers power-as.sisted 
statement construction. Vocabulary 
access in a single mousedick. 


MultifuncliorvnrttFand replace. A 
variable watcher and expre.s.sion 
evaluator. Took to change variairle 
values or try out commands, in 
context, in the middle of debugging. 
Automatic navigation to subroutines. 
Background processing. An 
enhanced trace log. Extensive Drag 
and Drop support. We could go 
on, but we just don't have the 
space here. So get a copy today, 
and start scripting widi power! 


I f you're an AppleScript novice, 
Scripter will lake you by die 
hand and show you the correa 
.syntax for your siaiemenis. If you 
kiiow what you’re doing, Scripter 
will help you do it faster than 
any other editor. And Scripter is 
the only tool on the market with 
interactive (Mnggir^: You catch 
the offending code in the act. 
Only Scripter lets you fix the 
problem and continue deliugging! 


'Ihe MacMxpth Scripting Company 
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its well as the a^k* far uixkuin^; all the elients. (Jne of the 
drawl yacks of Inier-Prrx'ess Coniinuriication Ls tlead-kx'king. li’ one 
methcxl aills ancxJier nielluK! on the otliersidCt and thiii mediod has 
a t^^lilrack to tiie [irsi side, llie two sitlcs could Ix f>kxked waiting 
for the Ollier to cojiipiele. Using perform:aflerOelay inethfKls prevent 
iliis. 'Ilie per1brm:afterDe[ay will wait uniil the next lime ilirough the 
event loop and peiforni tliat meiliod. Tlie original calls will then not 
dead-kx'k. OPENS^fEP's dLstributed objects are not l(xi seasilive to 
de;td-lcx:king, but it Ls a gotKl Itibit to airvays protcit agaiasi it 

ti^tiDR 3; Client-Hefver coraraunications 
- updateEveryoneAfterPtflay 
t 

[r13 ont Lis1 makeObj ect sPe r forra:@seIecto r{upda teStats) 
with; nilj ; 
return self: 


‘ (voidlupdateEveryone 

t 

tael f perforitt:^selector(updateEveryonc) 
wiltonil alterDeiay:! canoelPrevious*yES]; 
return: 

I 

- (void)addClient:e1ient: 

I 

IclientLiKt addObjectlfAbsenticlient I; 

[self LipdaLeEveryonej: 

J 

(void)removeClient;client; 

t 

[clientLiat removeObject*client1; 

[self updateEveryone]: 

I 


(List "jelientList 

r 

return clientLIsts 
I 

(vold)updateStats: 

■I 

fuelf; perforoi:@selector((ipdateSiaLiiAfterOeiay) With:nil 
afterUeiayM cancelPrevlonn: YRS] : 

I 

Whenever a client Ls added or removed, ilie server trills its 
updateEveryone iiieih<xL Tliat methcKl wall wait until the next event 
l(x)p, ttill updateEveryoneAfterOelay. updateEveryoneAfterDelay calls 
updateStats in every client, whicfi will cal! each clients 
updateStatsAfterDelay after a delay. updateStatsAfterDelay will 
rebuild everything. Whenever any ilienr changers, it can call 
updateEveryone in the server and eveiy client will update. 

The last three routines needed for netw^orking aie to send ilie 
actual data. 1 he eat: method saves ihe uscts choice and updates 
all liic c:lienrs. Each dlenr’s UpdateStatsAfterDelay meth<xl must 
find out w'liea^ each user wants to eai by calling wanEToEatWhere 
method. In our ctxle, the updateSlatsNow only passes the list of 
dienls lo the LunchView, die LunchView will call 
wantToEatWhere. Tfiese 3 routines are listed in listing A. 

Listing k 
■ sender 
I 

[where release] i 

where = [KSStrlng stringWUhCSiriiigr [ (TextFieid 
•JlunchField stringValuft]]: 

[remoteHub updateFpveryone] i 
return self: 

I 
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' upd^toSiatsAfterDelay 

( 

List ‘sejrverClientLIst; 

SfiCverCiientList - [rettioteKub rlientList] : 
fiunchView updateLunchLli^i j scrvprCl if^T>rLl^Ttl : 
return self; 


(NSSlr!n& ‘JwantToEatWbete; 
I 

return wheret 
I 


Tlic cln>ic'c of where to eat is >sioretl in an NSString. RSString 
is part of the Foundation Kii instead of the AppKit. Intermingling 
different kiis is usually ti’ansparant. Foundation Kit oi>jeets piovide 
garl^age collection. Any objecT t:an lx.* set lo lx: auto-released and 
the next iteration of the event kx)p will all the objeas in the 
p(H)[. NSString returns a char * that will automatioaify lx freed later. 

LunchView 

Displaying Lite kinch results is done in the fAincliView. 
Lunch View is a sulxlass of view and as such, knows about 
setting up the display system. The actual code to display is 
simple, hut turning the distributed list into someiliing easy to 
display is a bit more complicated. In C+-i-, there would probably 
be 3 or 4 objects to do tliis, but in our example we will have 
only one helper t>biect. LunchChoice. Objective-C objecLs Lend 
to be larger than C++ objects. All functionality for viewing 
should lx placed in the view object. 

lAint:hChoiee, our helper object, will store one resUiurant 
efioice and the numlxr of times this restaurant has Ixcei 
requested. The code ts in Listings 5 and 6. Tlie LunchCholce 
stores the restaurant in an NS^String, which will take t:are of 
gari)age ct)llecting for us, 'I'he + sign before some of tlie methods 
are the same as C++ static methods, but arc called factory 
methods. I.unchChoice uses lltese fiictory methtxis to store tlie 
Max Value s<> Lunch View c'an scale appropriately. 

NEXTSTEP has a amvention of u.siiig init,.* for inltialaztion 
methocLs and free for freeing methods. OPFNSTRP has a 
convention for releasing objects instead of frexing iheriL Releasing, 
lailier than freeing, an olyjeci is used by ilie gadxige collection 
system. 'Phe initLocation metliod will call [super init], then an 
NSString object. Tlie free method is called whenever wc are done 
with this object, and it releases the NSString allcKailed as well as 
this object. The rest of the methods are straight-forward. 

Listing 5: Lunch Choice Header 
ffimpott <appkit/appkit,h> 

(f import <f oundat ion/ foundation * h> 
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Listing 6: LiinrhChoice Source 
^import **LuiidiGhoice,h'' 

eimplemen t a ti o n LunchChol cc 

static int HaxValuo ^ 0: 

+ RosorMiBxValue 

I 

MaxVulue = 0: 
return self; 


+ DutlMaxValue 
I 

return MaxValue; 


’ IriitLocation; (const char ') location 
[super initl; 

where “ [NSString stringWiLhCStrin&;locntionl; 
value - 0; 
return nelf; 


#Interface LuochChoice;Object 
( 

NSString “where; 
int value; 


F ResetMaxValue; 

+ Cint)HaxVslue: 

- InitLocation;(const char *)location; 
IrrereroentValue; 

(NSString *)location; 

- (int)value; 

' free; 

#end 


incrementValue; 
value++; 

If ( value > NaxVaItje ) 
HaxValue - value: 
return self; 


(NSString *)local ton; 
return where; 
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- (int)value: 

( 

roturti value; 

I 

free: 

f 

[where releaBe]: 
return [super free]: 

\ 

#end 

LunchView, iK'ing a subclass of view, has a siandanl 
initialization method called initFrame. initFrame will call [super init] 
and create storage for the list of choices. The free method will 
free all memory associated with LunchView. Unlike C++ with 
constRJctors and destructors, init and free methods must be 
manually c alled, 'lliese routines are in Listing 7. 

Lifting, 7: LunchView initialization and free methods 
‘ tniIt-rame: (const NXRect 
I 

[super initFrametfrm]; 
choices = [[List ailoc] init]: 
return self; 

) 

* free 

t 

[choices freeObJeetsl; 

[choices free]: 
return [super freel: 

Lunch View’s updateLunchList methcKl gels called whenever 
there is a ciiange in restauram. The list passed is k^ated in the 
server process, but fiy this point, it is transpaianr to Lunch View. 
Any cull to ilie list passed in will act like a call ttj a 10(111 object, 
bur Ix^ a liit sltwer. This rouiine deletes ilie existing list and 
rccraitcs a new list fVom scrjtcli Noi the most efficient 
algoritliiiis, but works for our purpases. The updateLunchList 
method calls the getChoice methcKl with a string value. The 
getChoice method will return a LunchChoke object of that rumie, 
creating one if necessitry. Oniv a LimchChoice is found, it’s value 
i.s incremented. When lire new^ li.sr has Ixen parsed, the view is 
resized and redrawn. The list luindling nnjtines are in Listing 8. 

Li fit lug B: LunchView's choice hand Hug methods 
(LunchChoice MgetChoice: (const cliiir M location 

I 

iot count: 

const char •thifijl^ocaiion; 

LunchCholceMhlsChoice: 

for I count = [choices count! ‘ 1: rouni >'^ 0: count- ) 

I 

thUCboice ^ [choiceB object At icountj: 
thisLocation - [[thisGholcp locationl cStringJ: 
if ( Istrcmp( thisLoratIon, location ) ) 
break: 

I 

if C count < 0 ) 

I 

thifiChoice 

t[LiiuchChoice ailocl InltLocat 1 on:location] : 

[choices addObject:thlsChoIco]: 

I 

return thisChalce; 

I 

* updateLunchList:1unebList; 

I 

i nt count; 

HSString HhisLocatlODi 


LunchObject •thlsaandier: 

LunchChoic e * t hisChoice; 

[choices freeObjectfil: 

[LunchChoice ResetMaxVatucl ; 

for (count = [lunchList count] - 1: count >= 0: count-) 

( 

thisHandler *= [lunchList objectAt:count] * 
thisLocation = [thisHandler tfantToEatVhorc]: 
ihlsChoice = [s^lf gerCholce:[thlsLocation cString]]; 
[thisChoice incrementValue}; 

1 

[self updateFrameSisse: [cbolces count] I: 

[self display]; 
return self; 


Frame resizing Is done in the update Fra meSize metliod. 
When a view in a scrolling view is resized, everything works 
correcily. No extra code Ls needed. However, axle to make sure 
the view doesn't shrink .smaller than the visible area is necessary. 
Otherwise, there will Ixr areas of the Scroll View that are not 
cleared correctly. This routine is in Listing 9. 

Listing 9: Frama handling 

updatcFrameS iso: [ int) numberOfGf>l mns 

i 

NXRect theFramf^, vinlbto&oiirjtli*; 

[self getFrame;&ihoFr*imel: 
f suparview gctVisibli?Kect:&vieibleBoiitids]: 

If (visibleBounde.size.width 

< numberOfColumns * kWldtbPerCotuan) 
theFrauie.size.width =" numberOfColunins ' kWidthPerColumn; 
else 

theFratiio.size,width viKibieBounds.slzo.width; 

[self setFrameJ&lhaFriunu] : 
return self; 

I 

The drawSelf method is responsible for all drawing. In 
generaL the rectangle to be upcLtied is passed a.s a pointer to 
ihis metlKKl and a rectCounl oi 1. However, for optimization, 

ii is po.ssihle to pass an additional 2 reels lo specify a non- 
rectangular area to update with a reetCount of 3^ The first 
rectangulc, however, juusi always contain a reel that can 
update the entire window. 

Wiien drawSelf is called the pastscri[X context has been set 
for the drawing. Pfjsiscripi commands sent to the postscript 
sc‘rvcr will lx prexessed and displayed. Hiere is a buffering built 
in, ,so there will lx little to no flicker. If there is any flicker, 
disabling the flushing is a single call. Morning the flushing back 
on and flushing the window will hla.st the pixels in one shot. 
Lunch View did not need tills extra bit of code. 

Mile first step i.s to set the font and color Lunch View is going 
to use. Mile font chosen is a screenFoni, hut if we want to print 
this window, OPENSTKP will automatically .swiicli a printer 
font. Next, a rectangle to draw each choice is created. Finally, 
(fie choices arc iterated ami informalitm i,s displayed. The 
NXRectFill shows a weighted value for each choice and the 
Psshow dis[>lays the choice. listing 10 has the source to drawSelf 
and Figure 3 has the final screenshot. 

Listing 10; 

' BravSelf: (coiiFt KXRkct Virucls; : (int)rectCount: 

( 

int count: 

NKRect thisRect; 
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PSsetgrayC NX_BLACK ]; 

[UFont newFont: "'Helvetica*' 

size: 10,0 mtrixjHX.lDiiNTITyMATRIX] screenFont] set]: 
thiaRect-origin,y * bounds,origin.y ■+ kOffsci*?.; 
thisRect,origin*x * bounds.origin.x ^ kOfCset: 
thisRect.size.width - thisRect.size,width + kWidthPerColumn 
- k0frsef2: 

NXFraseRectt rects h 

for C count = [choices count] - I: count >= 0: count- ) 
i 

LunchCholce*thisChoice = [choices objectAt:count]: 

FS(ioveto( thisRoct^origin.x + kOffset* 
bounds.origin.y i kOffset ); 

PHahow( [[thisChaice location] cStriag] ): 
thisRect .size.height 

[bounds.size.height kOffget*3)* 

([float) IthisChoice value])/ 

((float) iLunchChoice MaxValue]}: 

NXRectFllK &thisRect ); 

ihlsRect ,origln.x kWidthPerGolunin; 

I 

return self: 

I 



Figure 5. 

WllAT ELSE CAN I DO THAT IS EASY? 

From inted'acti Bui I tier, printing and spell checking can 
be added wiih no coding ai all. Setting a font would require 
an additional method, but roughly only 5 lines of code would 
be added or changed. 

Setting np a chat line so people can talk while tills is going 
on wouldn’t t^e difficult at all. ^Ihe list of LunfhOhjcc:t.s is ala.‘ady 
distributed, so a list of chat objecls am lx: easily added. 

Ferhaps statistics sliould lie kept, OPENSTEP provides an 
NXSlringTable object tliat allows storage to a file of a kc 7 value 
pair, llie NXStringlable objea makes simple liasliing a dream. 

When marketing droids say that developing in 
OPENSTEP is 3 times as fast as conventional development, 
everyone doubts them. From personal expcncnce, IVe found 
it to he an almost 10-fold increase. This entire application, 
including complete networking code, took me less than 4 
hours to write. How long would it take uj write this same 
application on a Macinujsh or under Windows? B 
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TOOLS OF 
THE TRADE 


hy Hdivard Ringei 


OpenDialog 



Specialized dialog functions 
library for the industrkd 
strength programmer 


'riic Dialog Manager Is a Hexihle 
package ihai is used l>y almost everyone 
creating forms for Macintosh apjijlications. 
For some applications, these forms are 
limited to setting [^references or a few 
taher limited tasks. In this situation, 
extensive custom iy^ii ion of the dialog is 
Linnecessaiy, and T(H)lhox tails are more 
than sufficient. In other circuntstances, a 
series of dialogs, modal and modeless, 
may be tlie ct>re of tlie project and 
represent the bulk of the u.ser interface. In 
these appiicationsj customization of the 
dialogs may be desirable and even 
mandatory. In this .setting, the direct Dialog 
Manager calls may K* clumsy and require 
large iiiiKHmts of c<Kling to achieve input 
filtering, relating data slruclures to items, 
cursor management, and die like. 

Objeci oriented technologies have 
devi.sed .schemes to excR'ist* considerahle 
ctmtrol over fomis-style GUIs. Prtjcedural 
pixigrammers usually have a collection of 
routines and libraries tucked away which 
simplify the problem, at least to a dega^^e. 
From lime to time various pRjgramniing 
tools lx.s:omc ava!hil>lc which also purport 
to simplify the life of the dialog-forms 
pn)gramnier OpenDialog Ls such a package. 


Dl\u>o Mana<;I‘R Repiacfmknt 

OpenDialog Is engineered and suppoited by FGM, Inc. of 
Herndon, VA. This company’s primary business activity is writing 
end-user software, not crctiting programming tools. Nonetheless, 
their collection of routines and tlicir systemattc approach to 
addrc‘ssing Dialog Manager problems and deficienciCvS resulted in 
a I library that cieariy has commercial appeal, As FGM states in its 
ads and introductory^ liieralLtre, diis is a replacement for the 
Dialog Manager, l! is rectimmended that you do not use 
OtKmDialog and Dialog Manager calls on OjieiiDialog dialogs 
because, as the manual says, "tlie resuhs may lx? unreliable." 

When OpenDialog creates a new' diak)g (modal, moveable 
iiKxlah and mtxleless dialogs are all supported) it create.s private 


object oriented technologies have devised 
schemes to exercise considerable 
control over forms-style GUIs. 


data structures and tags tlie dialog as its own* The lilirary' supplies 
a function, DMX_lt 2 aODIogWindow(), to test whether a dialog 
iielongs to the OpenDialog manager or not. As a replacement for 
the Dialog Manager, OjxmDialog 1ms an etiuivalent llinctkm for 
just alxjul all of the Dialog Manager functions. 

With the exception of a few Lulls, the replacement FurLction 
and the original function have very similar names and 
parameter lists; this is obviously helpful and miporiant* 
Parameter lists are differenl when functionality Ls extended. 
DMX^GetNewDialogO may lie a gotxJ example; this function’s 
parameter list allows the programmer to specify if the diak>g is 


Fd Kingel is Contributing Editor for prodtin reviews for MacTech Magazine. In hLs spare time, he is a respiraicjry and critical 
t^tre physician in Waienrile, Maine. He can reached at eringel@mint.net. 
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Lo fx! mKk\ r>r modcile.ss, to assign a text ^lylc for the dialog, 
and to sci Hags Ftjr event handling. 

A5 may be apparent from these two firnction call 
examples, the function calls all start with DMX_^ this permits 
easy differentiation from Tocjlhox calls in your code. 
Ihroughout the library, there is a clear and consistent 
nomenclature that was very ea.sy \o follow^ this helped 
shorten the framing curve considerably. 

Extetnsions to niE Diau)Ci Managfh 
Clearly, mv does not purchase a library to simply have a 
different prefix to a fumlion, OpenDiak>g provides a very wide 
range of extensions to the scTvices provided by the 'icKilbox. 

One very nice feature of the jircxlLict is item tagging. Kvery 
item in a dialog can have text asstKiated with it; Oj>enDialog 
takes advantage of this to alk>w for cii.siomi/.^itk)n of the item at 
tlu? rt‘soiirce level. As J describe below, one powerful use of this 
feature is to cusiomi/.e an edit field to create filtering. Anollier Ls 
to “name’* an item and free the programmer from needing to 
rememlx'r a Dfll ntimlx*r Contmls and otlicr elements may also 
be customized with item tagging. 1 think that the ability to set 
filtering (and other services) ai the resource level is in the Ix^st 
spirit of Macintosh prograniming UxjIs. 

The latgcsi (and probably for niiiny programmers, the mexst 
important) gioup of services have tt> do with cxlitable text boxes. 
By tagging the edit text item’s default text in the resource editor, 
one can liniii the numlxr of charactei^ in an entry, force numerical 
data only, etc. Celling and setting data from a text lx>x is much, 
mix'h easier lliiin with Ttx>llx)x calls. To get any item’s text, one 
sim[dy calls pascal void DMX_GetltemTe)ct(const DialogRr aDlog, short 
altemNumber, Str255 aString), ami to set the text, one calls tlie 
counterpart function, pascal void DMX_SetltemText(const DialogPtr 
aDlog, short altemNumber, const Str255 aString). Speciali/±‘d getters 
and setters for date, time and latitude and longitude are also 
supplied. Although one miglil funciionany grrxip cursor cx>nirol 
witit other types of service extension, die library supplies an 
automatic l-liemii cursor if the field Is initixilized conealy. To give 
a flavor of OpenDialog calls, Ix'low Is a listing from a short program 
1 converted to DpenDialog. 'ITiis function crcates a mtxleless 
dialog, counts tlic nuinlx:r of dialog items, tests to see if the item Is 
of type editText, and if it is, irisialls automate l-Be^tm management 

void CreateModelessDialog(flhort DlnlogJU. DialogPtr 
*theN<fwDlalog) 

I 

short tempTypft; 

short numttGtiR: 

short 1: 

*thoNr?wtlialo^ “ tiULt; 

Hhol^cwDlalo^ - DHX_Getl3ewDlalog 

(DiaiogXD, kDMX_ModelRS^l, OU,knMFlaj^DoldleEvents); 

If (‘theNewDialog !“NULL) [ 

numltems = DMX Cmmtl)ITL(* iheNewDialog) +1: 
for {i“l j i<ntjipTioras: i++) ( * 

tempTypp ^ nHJLjGctitemTypeCrheNewDialog.i): 
if (r<*iBpTy[i€™edltText) 

DHX_SctlBarPlag(’theNewDialo&,i.true); 

1 

Show Wind ow(* t h eN ewDia X og); 

SetPori(* theKewDialog): 

I 

return; 


WHY INSnUER VISE? 

ASX MEIROWBIKS. 

“histalling CAideWarrior is a herculean task, we ship 
ot>er 400 megaftytes on each Qxle Warrior CD release. 

It would frankly he impossible for us to undertake this 
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Add Universal Spellchecking to 
your application for free with 
the Word Services Suite. 

•The Word Smices Suite Jtlkws any applicmkjn a) link ii> a spelter, 
gj^iiiiiar checker or other text service as if it is hiill-in. 

• It is a pubiit: pnXticol: no tkcnse fee or nondisclosuie is tequiied 

• Your lisas may pimiiase services in a variety oHangUtiges. 

• Savioes mtiy be shaied among several upplk'alitxis. 

• Wool Sovioes is easy to inipSemait -it iLsuttlly takes two days. 

• It is gieal fcT in4xHisc, homemade and veiliad Lipplicatiofis. 

* Wad Services has been ;in indii?3ry standard on MacOi since 199Z 
■ A BeOS ven>iai is caning sooa 
• It will w^ik unrriotJified under MacOS 8, 

• It is very teliabk!^ and patches no traps. 

• Client and saver vetKioos the piaocol spedfiaakn tutorial drxu- 
menLs, and ihe souru: axle to a client called WritcsHt'li Jr. iire at: 

http://www.wordservices.org/ 

• Spellchark WSI Nra-sWaldier-gja the stiurtTe axle free! 

• Spelldieck your H>|XT<iird lields - gel ihe XCMD free! 

• Cxi help with Word Sicrvices questions tioni: 

Crawford Software Consulting 

130 Indian Hollow. Unit B 

Aptos, CA 95003 

crawford^scruznet.coin (408) 685-9019 


0[x:nDiaIog also supjx>rl.s a variety of extensions to the 
dialog manager that are not directly edit-field ablated. Amcmg 
others, CD has scntillahle lexU twisters {Finder type triangles), 
and specialized supfKirl for multiple pane dialogs. Althougli 
some elements, such as lists, are not supporteLl clirectly, there is 
help provided with functions such as DMX_CoiJldFocus(), which 
allows the active user item to receive keyhtiarti events. 

OpenDialog cuntaias a number of ver>^ valuable utility 
functions. It has a fairly large subset of ANSI libniry and other 
string and number utility functions, which eliminate 
de]>endence on much of the ANSI library functions. There’s a 
nice call that gets extensive volume information. There are 
several functions for putting up a quick ''(piestjon*’ alert, an 
error mes.sage alert, and a password dialog. 

Perhaps of greatest utility are llm callback functions. One 
can attacli a cal)l>ack to any item for any purpose. (Well, 1 
guess Fm exaggerating a little, but you really can attach a 
callback to any item.) Kvent handlers, Sfiectalized update 
routines, data entry filters, cursor callbacks, action procedures 
and the like can all be attached with relative ease. While this 
part of the package has the steepest learning curve, it clearly 
also holds the most lM)unly. Since much of the mteraction is 
with die Toolbox, many of the tullbacks are framed as 
Universal FrcKeclure (Pointers, and appropriate macros are 
provided. All in all, iliis is a very robust package. 


What OpenDialog is Not 

Open Dialog is nut a GUI builder, nor is it an application 
sliell. Thi.s is a replacement and extension to the Dialog Manager, 
and no other services are provided, excej>t in bits and pieces. For 
example, in my program which I converted CO OD, I still had to 
SetPorlO on my own after bringing a modeless window to the 
front. Window Manager routines work on OpenDialog dialogs 
without difRailty^ and are used extensively when working with 
modeless dialogs. I think it is partkailarly important that 
OpenDialog’s limitation be recognized. The novice or early 
intermediate programmer w'ill certainly be able to use die 
package, but will feel somewhat unsupported in the lack of 
event loop support and help with printing, etc. 

Documentation 

The documentation of this package is difficult to 
cliaracterize, as parts of it are very good, and other parts are 
problemaitc. There is an initial short ininxluclion to the 
OpenDialog programming paradigm, and the remainder of the 
manual is a description of ail the functions. Tlie document, as 1 
received it, was in e-ckx: format and alxiut 12 months out of date. 


The documentation of this package is 
difficult to characterize, as parts of it are 
very good, and other parts are problematic. 


A large supplement of functions had been added and were in a 
Simple Text “Read Me" file. 

Tile documentation present is quite good. The function 
descriptions follow' a nice formal, and I knew how to use a 
given Function after reading the manual section describing it. 
Tlie intrtHluction gave me a good general feel for how the 
guys at FGM were approaching the dialog problem, e-doc 
format does not permit hypertext cross referencing — I think 
this is a must for electronic documentation; I would very much 
have liked to see some means of accessing a function 
descriptit)n rapidly, I was unhappy that the manual was 
dozens of new functions out of date. 

The primary instrutiion for die real-life use of the program 
is in the sample prtigram and die DMC.li header file. Tlic sample 
program is large, complex, and somewhat hard to follow; the 
demo shows off die features nicely, but I would have preferred 
a series of smaller programs that were easier to read and digest. 
My test conversion program irsed mcxleless dialogs, and there 
was no demonstration of hr>w to use Openl^ialog for modeless 
dialog work. An email to FGM resolved this quickly, and Charlie 
Vass, the engineer, was most helpful. When all is said and done, 
die information is there, and de.scribes the j>roduc1 correedy, but 
could do with impmvement in formatling and accessibility. 
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Till- Bdi'iom Line 

OpunDiulog is a set of [:Kjworful routines diat can siniplify 
life trenicridoysly lor prognunniens pushing the Dialog Manager 
to irs limits. I could sec this pnxliict being quite helpful to 
anyone developing complex electronic forin.s in a prtx'edunil 
language. Tliere is probably less of a need for diis prtxluci with 
object oriented frainewt>rk.s. given the- design paradigm of a 
window view ohjecl populated by olIilt views object, lliis 
I^rtKluct slujuld not be used by a novice programmer. 

OpenDialog Ls available directly from FGM for LISS 259. Tile 
pac'kage consists of dcKumentaiion, a header File, and both 68K 
and PPC liliraries for CcxleWarrior Libraries are availal>le for the 
Synrumtec environment. All functions are declared pascal, and the 
commercial package comes with a Pa.st:^il interface file, 

OpenDialog late Ls a free, limited version of OpenDialog 
(lacks some of llic newer functions and does not have any 
ckKiimentation except for tlic sample program anci header file) 
and is available on the CW 11 disk. IPs a great way to test drive 
the prcKliict, I uige anyone with some programming exjieHence 
and a need for sophisticated forms to look into this package. 

Products Rfvifwfd in this Article 
OpenDialog, version 1,23 using C interhice and CW' 10. 

IJsFnu L lIRI/s 

<vww.fgm,com> 



t>est high 
performance, 
portable 
compression 
\ libraries for 

\ DOS/ Windows, 

\ .w. \ OS/2/ Unix, 

\ L® Macintosh/ 

\ embedded systems, 

and practically anything 
else, period. 

New Version 3.2 

Robusi, 45-Funchon API DOS $249 

Buffer Grid File Compression Winl 6 $299 

Portoble Archives ond Data Win32 $299 

Disk Spanning OS/2 $349 

Encryption Unix $349 

Self-Extracting Executables Mocintosh $349 

On-line Help 

Full C Source Code FREE DEMO 

Tel 606245-4175 
n/"* 606-245-9305 

ES 'V info@dcmicro.com 

Development hrtpy/www.dcmicro.com 

Call 1-800-775-1073 



Help Make MacTech Work 


Here at MacTeeb wc rely hc^ivily on 

outside writers for most of the niiilerial lliat 
appears in our pages, if readers did not 
pmicipato in the magazine, sending us their 
i(leas and Taking tlie time to write articles, there 
would Ix^ no MacTech. McAcTech Mc^azim is 
not 3 .stall of writers sending a coasiant stream 
of one-way messages outwards; it's a living, 
evolving network of rcadeis amversing with 
one anodier, educating tme anodicr, sharing 
tixir knowledge, dieir ex|Terience, ilieir interest, 
their trkils and iribiikitionHS and 
successes in die constantly unfolding story of 
pnigiaimning the Macintosh, MacTech 
Mof^zine dexsn't ju.st hapfien: il’.s w hat the 
conimuniiy makes it. If we carry reports of 
Future triends arxl technologies, if we teach 


useful metbocLs, i/ we mview new btxjks arx! 
tools, if we pPTft'oke rhouglu, prtivkk lic-lp, ride 
the w^ve of ainent inieiTesrs and concerns, it is 
only because we reflect the tliougliLs of our 
a^Tders, who speak through nur jiages. 

You are invited to involve yourself in 
this exciting conversation amongst readers. 
No matter who you are, no matter what your 
credentials nuiy be, if you have a tale to tell, 
a trick to siiare, a technique to teach, we 
want you to consider joining die family of 
those who write for MacTech. 

Don't just wait for a TOf>ic to lx? covered 
or a technique explained in MacTechf Take 
respon,sil>ilityf Write us an article yourself! 

To write for MacTuch, just send for our 
Writer's Kil. It's a Microsoft Word file 


containing the Styles you need to use, and 
giving lots of helpful advice and infomiation, 
including all the legal stul^. You can let tis 
know what you’re writing about, or, if you 
want to, you can just write the article and 
spring it on us wlicn it's done. INotc; We 
also have a need for people willing to make 
themselves available to write occ^asional 
product/book reviews.l IF we publish your 
article, you'll be paid for id 

Write to us, die editorial stalT, at 
ediiorial@mactech.com {or one of tire other 
addresses listed on page 2 of the magazine). 
Take the future of MacTech Magazine into 
your own bunds I 

■ P i h I I ■i n 

tf A e A £ I H g 
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by Nicholas C. ‘'nick.c" DeMelio 


The NeXT Big Thing 

Questions about the NeXT/Apple merger, 
and where to find the answers — Online. 

Why? — The Technologies NeXT ls Bringing i'O mE Mac 

So, why did Apple chtxxsc NeXf? It's no secret tha Apple ms 
shopping For new OS technologies. At a minimum, Apple w'^inted to 
int:orponilc preemptive multitasking, proietiLxl memory, and sym¬ 
metric multiprfx:essing into tlieir new^ operating system — 
Khapsfxiy. All of lliesc feaiuies exist in the iVlach mkTokemei 
(dc’veloixjd at Carnegie Mellon Univeniity and then refined by 
NeXT) and the NeXr OPFNSTFP API built on it. Apple’s plans for 
ld\;ipsody involve a complete implementation of the airreni MacOS 
nmtime environment (called the Blue Box), as %vcil as a frarallel 
implementation of an OPKNS'rF.P txused API Uhe Yellow liox), lx)th 
built upon tlie Mach iniax^kcmcl. This architeaure is outlined on 
Apple's Rluipstxly web site and will allow foj- ('ompatibility wit h cur¬ 
rent software, without relying on emulation, li will alscj allow the 
Yellow Box to devek>p to it’s fullest, without Ixnng held Irack by 
having to maintain compatibility with old system techmjlogics. 

However, NeXT bmughi more tlian the minimum to tlie table, 
lieyond die Mach kernel, anti tlie OPENSTEP based Al^l for tnteraa- 
ing with it, NeXT also bixxight along WeliObjetTs. WeliObjccLs avc 
piebuilt application modules with development ttxds for coml:jining 
those rejects into caiscom apfilications to manage dynamic web 
liascd applioikms. Beyond simple HTML tVimis, WeliObjecis allows 
[irogrammers to develop powerflil datalxise Ihmtends and applka- 
tioas, 'Ihe overview of WclOfijetts cjii NeXTs w'elislte leminds its 
tJiat the first world wide web client and server was crated using the 
NeXT tec hnology which ev'oivtxl into >Xi*l)Objecl.s — tlie teclmology 
Ls not only powerflil, iPs pn>ven with over 10 yeiirs of development 

Rhapsody, a Breakdown of the Components of the New OS 
<http://www.macos.apple- com/marc t elt^^ses,^ rl 1 apsody/.] r c hcl ia g ram. html> 

Rhapsody PDF White Paper 
<htTp://www.3pple.be/Aaobai/Rhapsody.pdl> 

WebObjects Overview 

<http://www.neKi.cofn/WebObjects/Ovcrview.htm]> 



How? — Tools for the NeXT Gfneraiion 

Rhapsody’s native language will l)e Objective-C. In the 
online MacOS and NeXT technologies FAQ, Apple assures us 
that they intend to allow developers to create applications for 
Rliapst>dy in Java, C, C++, and Pasc'al — but also mentions that 
there ttnll be advantages u> developing in Objective-C. 

T'ho.se of us not familiar with Objective-C will want to 
check out the Objective-C world wide well pages, maintained 
by Steve Dekorte. Thc.se pages provide an overview of 
Objective-C, eomments on i!’.s history, listings of reference 
information, language comparisons, and links to other 
Objective-C pages. Also, NeXT liosts a series of web pages 
discussing OOP programming with Objeetive-C which cover 
the Ob]cclive-C language, extensions, rumiimc, and an 
oveiview of OOP principles. This site also supplies a refer¬ 
ence manual and an Objeclive-C summary. 

However, knowing Objeclive-C won't do us much gocxl 
without compilers, Metrowerks has accepted that challenge, 
announcing that they expect to develop an Objective-C com¬ 
piler for CodeWarrior and develop Objective-C runliiiic sup- 
pon in iheir C++ compilers by the 1997 A^iple World Wide 
Developers Conference, Actording to the Metrowerks web site, 
they al.sf> expect to be able to port CodeWarrior compilers and 
linkers to Rhapsody’s Yellow Br^x siinulianeous with the 
release of the new' OS, gelling a developers release of the new 
tools tf> tlevek>pers at MacWfnld San Francisco 1998, 

MacOS and NeXT Technologies FAQ 

<http: //matos. apple.com/macos/releases/rha psody/faq. rhap, him l> 

The Objective C World Wide Web Pages 

<http: //WWW. ba tech, com/ - de korte/Objecirve ■ C/objc.html > 

Object Oriented Programming and the Objective C Language 
<hbt ip://vvww,neKt.com/Pubs/Documer ts/OPE NST E P/Obj ectiveC/objctoc, htm> 

C Net Article Metrowerks to Build Rhapsody Tools 
< hap://Www.news.coni/News/ltefn/ 0 , 4 , 6 ^ J 14 , OO.html > 

Metrowerks to Include Rhapsody Tools in Regular CW Subscriptions 
<bnp://www.meirowerks,com/news/press/ne wos.html > 


Mck /)^*Mello is MacTech k Online Presence — you re likely to find him gossiping in Usenet sfiace, cruising Ix.^iiieen iwh sites, or delmig 
into miej^iored ftp mulls in search ofi tiew cade, inkresling resources, and other buried treasures, fn this column, Nkk .shares his most 
recent intemet trawLs and discoveries with the MacTech ai4diefice. Pmders are encoumged to reHim the fiavor by writing Nick at 
<Vkh^maciechxom> to report online resources fior Macinlosh programmers. Ihe compreheftsim* MacTech URL datalHise at 
<hilp://www.JYiactech.coni/magazirie/uris/> mcludL% hut is not limited to, the URL's reIxMvd in MacTech Online. 
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THE 

CLASSIFIEDS 


The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectual 
Property, Corporate, Commercial and Contract 
law, as well as Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need 
help establishing or maintaining your business, 
please give me a call or an e-mail. Reasonable fees. 

( 310 ) 553-4054 
Brad@Sniderman.com 


M acTech Magazine is youi* 
recruitment vehicle 

When you need to fill important positions at your 
company, MacTech Magazine is the consistent 
choice of companies across the country for hiring 
the best qualified Macintosh programmers and 
developers. Let MacTech Magazine deliver your 
recruit-ment message to an audience of over 
27,000 qualified computer professionals. 

Call Ruth Subrin at 
805/494-9797 


Our Server is loaded." 



-MacXpirtt 
PfograMuitr 
ftVolleybillcf 
ray«iabaui 
havinf thelnt 
develDpnitnt 
itfi anywhtf*. 


Programmers & 
Adventurers Wanted 

MneXportt Isa softwiirc^develaper 
with Immediate openings for 
Macintosh & Newton prograntmen 
with C, C+-f, OpenDoc, iava or other 
programming experience^ 

Take the first step to adventure- 
Call Michael Rutile at: 

1-»06 m-8M0 or fu/BH-ISa-1847 

hltp:>/www. maotpert5.com 
email: wor1t@niACJipert5.com H 


NEED: A FEW GOOD 

MAC DEVELOPERS 

Perceptive Scicniilk Insiru- 
mems, inc., bused nenr 
HoiLston, TexHS. is lixiking for 
Mile develojiers with 2 - 5 
yarns experience ttj develop 
iLs Genetics prod net line. 
Strong C/C++ prognimining 
and analytical skills are 
essential. Experience with 
OOP Hi digital image 
processing will l>e a plus. 
Send resume to 11. Baxi, PSlk 
2525 S. Shore Hlvd, Ijeague 
City, TX 77573 tjr fax to (2B1) 
538-2222 or email to 
hbaxi^persLa.mm, 


Mac Registry ™ O 

Developer Job Opportunities 


If you arc a Macintosh developer^ you should register with us I 
We have adataba.se lhal enables us to let you know abiTuI job 
opportunities. When we are asked to do a search by a client 
condpany the database is the llrsl place wc go, rhej'e is no 
charge for registering. The database ,seivice is free. Geo¬ 
graphic Coverage is nationwide. 

Marketahilily Assessment - To gel a specific feel for your 
rnarkclability send a resume via Email or calL You may also 
request a Resume Workbook & Career Planner. 

Discreei - We arc very careful to protect the conridentiality of 
a currently employed developer. 

Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for compeleni & protessional job place¬ 
ment services and we arc Mac fanatics. 

1 “800-231-5920 ■ das@spi.cotn • Fax 1-800-757-9003 

http://www.scientific.com 

Scientific Placement, Inc. 

MT. Bon 19949. Haislun. TX 77224.2«l-496-fil00 Fa*: 2X1 4% 0373 
MT.Box7l,SiuiRiiinon. CA94S83 5K>-733-fil68 liclli«spica.bdl.com 
MT. Box 202676. Austin. TX78720-2676 S 12-26(1-0123 lej@xilkerjict: 
C^iiipuservu; 712S0.300I: AOL: davmnaK 



iTHkTTIEII NETWORK 


■he Tmttner Nciworit. ’The OigUiU Tafom Source', it lookihg for experier>ced 
Macinttjsh developers (br cutlmg edge opportunRies m Norihetn CelKomia and 
NAhoriwide- 

T tn m plugged in to In Ul, Iniiertiet. Muthmedm. Cross platform 

ths holtesi developmeel 


N 


OW —you can visit our web site at www.tratnctcam and see whet 
openings are available tor.. 


JAVA/Inlemct Stars 
QPJQC Professionals 
Mullimedra Devotopers 


> Software Developers 
- Project Coordinatof/Mnnngor 
. Network Professionals 


Ttwi Trattner Network hiia a unique hfelory in Mac consulting 
coupled with exposure to emerging lechrKikjgiRs. if you am lookiog for 
a chance io enhance your eltilte and marketability plaase email, fax, 
or link your rostimo to: 

The TraUner Network 
Attn. Debbie StPvons 

170 Slato Si, Suiib 240 - Loa Anus. CA 04022 
Phone (415J 049-0565 exL 115 * Fa* (415) 040 102fi 
AppleLink. baLnel 
emaN ^tevens@traliiet.com 
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PROGRAMMER'S 

CHALLENGE 


By Bob Boomtra, Weslford, AiA 



Equation Evaluator 

iliose of you with PowerPCs have prolrably experimented 
wirh the Grapliing Caleulaior application installed by default into 
tlie Apple Menu Items folder. As one of the first native applicration.s 
for the PowerPC, the ability of the Gniphing Calculator to display, 
and even animate 2-dimcasional and 3-dimensional equations 
demoastraling the computing power of the PowerPC chip using 
native code. Underlying the display capability is cxxlc to parse an 
eqimiion and rapidly compute tlte equation value for a mnge of 
input values. In this month's Cliallenge, you will produce code to 
perform these parsing and computation functions. 

Ilie prf)totype for the code you should write Is; 


The input ©quation you are to evaluate w^ill be provided as 
a null-terminated string in the 2-dimensional curve fomi 
C.y=x+2x^2) or the 3-dimensional surface form (z-r cos(t) r sin(t)). 
You are to evaluate the equation for each of the values of x and 
n (in the case of a 2-dimensional equation) or x, y, and n (in the 
3-dimensional ca.se) provided and return the results in the 
preallocxited array w. Each input is described as an initial value, 
a della l>etween each value and the next value, and itie number 
howMany of values this input parameter is to assume. For 
example, if x is to take on die range of values [1.0, 1.1, 1.2,... 
2,0], then the x input could be dea'ribed as: 

xP-)first = 1*0: KF->deltfi * .1: xP->howMany =11 


typedef u!isigiied long ulang: 

typBdef struci Values i 

float fir at; p firsi equation input value 7 

float delta; p first+dt:Iui issccund input value 7 

u 1 on g ho wMa ny ; P numbi-*r of input values V 

1 VaJues; 

typedef struct IntValues [ 

long flr&i; P Cm\ equation input value V 

longdelta; P first+delta is second input value V 

u 1 0 n g h QwH an y; /* number of inp ut values 7 

1 IntValUQs: 


typedef struct Rosulta I 

float e qua t io nRe suit; P rcsuli of 1 x 41131 ion given sc 7 

float X; P input value of x producing equationResiili 7 

float y: P input value of x producing cquationRc^lt 7 

1 ong n; P input value of x producing equationKcsuU 7 

1 Results: 


void Evaluolef 
char ‘equation, 
const Values *xP* 
const Values *yP* 
const IntValues *nP. 
Re.sultfl wU 


/* niiit-tcrminatcd equation to es-aluatt 7 
P equation inpin values ftw x 7 
P equation input vahics (bf y 7 
P equaiitni input values for n 7 
P pteanocaicd storage for equation s-alucs V 


In the event that the equation does not contain one of the 
input parameters, that paratneter should be ignt>rcd. There is no 
guarantee^ for example, that nP->howMany will Itc zero when the 
input equation is not a function of n. Similarly, for a 2- 
dimensional equation, yP should be ignored. 

The input equation might be wriuen as a function of r and 6^ 
which slioukl lx: calculated from x and y just as the Grapliing 
Calculator does. Because the Graphing Calculator ilisplays 
equations in ways that cannot be directly represented in a 
character siring, the following symixds will used in the 
equation to represent the operator or value indicated: 

\ scfintre rom 
/ division 
^ exponentiation 
p pi (it) 
t dieta (0) 

multiplication (also represented by juxiapt>sition) 


THE RULES 


Here's huw il wtjrks: each monih we present a new programming 
challenge. First, write some code that solves die challenge. Second, optijni^ie 
your code (a loi)i Tlien* submit your solution to MucTech Maga/itie. We 
dioose a winner based on code correctness, speed, size, and elegance <in 
thaL order of importance) as well as the submission date. In the event of 
multiple equally desirable solutions, we’ll choose one winner (with 
honorable mention, bui no prize, given to the runner up). Tlw prize for each 
month’s best solution us a S100 credit for Developer Depot™, 

Unless stated otherwise in the problem statement, the fdlowlng rules apply: 
All solutions must be in ANSI compatible C or C++, or in Pascal. Wc disrjuaiify 
entries witii any assembly in tlreni (except for challenges specifically serting 
txherwtse.) You may call any Macintosh Toolbox nxttine (e.g,, it doesn’t matter if 
you use NcwPtr instead of rnalloc). We compile oil entries into native PowerPC 
code with compiler options set to enable all available speed opUmizations. The 
devetopmenT environment to be used for selecting the winner will be slated in die 
problem. Umh your code to 60 characters per Bnc or compmss and hinbex itx; 


solution; this helps wiiJi ennajl gateway’s and fxtge layout. 

We publish the solution and winners For each month’s Krogiammer’s 
Challenge three months later. AH submissions must be received by the 1st day 
of the montlj printed on die front cover of this issue. 

You can get a head start on ihe Challenge by reading the Programmer's 
Challenge niaiimg list. It will be posted to die list on or before the 12th of the 
preceding month. To pin, send an email lo lisiservlDtistinail.xplain.com with 
the subject '^subscribe chaUenge-A'. 

Mark solutions *Attit: Programmer's Challenge Solution" amt send it by 
e-ntail to one of the Pnogramnier’s Challenge addresses in the “How to 
Communicate With Us" section on page 2 of this issue. Include the solution, 
alt rciated files, and yoitr contact info. 

MacTech Magazine reserv-es the right to publish any solution entered in 
the Programmers Challenge, Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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iitandard algebraic o|)erator precedence .should l)e used: 
exponentiation and square roots, then multiplication and 
division, then addition and subtraction, with lefit-to-right 
evaluation order for oj>eralors of equal precedence, and with 
parentheses used to override normal precedence. Arguments to 
trigonometric functions will always be surrounded by 
parentheses. Wliere the Grapiling Calculator would use 
superscripts to indicate an extended exponent, parentheses will 
(xi used CO make the meaning clear (e g., e^(x+y}). 

Store the equation result for die i-lh combination of input 
values in w[i]->equationResult, and store the corresponding 
input values in w[ib>Xp w[i]->y, and w[ib>n. The results may be 
stored in any order, liui each input a>mbination should appear 
exactly once. Results should be calculated widi a minimum 
relative accuracy of .00001. 

Even diough the Graphing Calailator handles inequalities, 
multiple equations, differentiation, siinplillcaiion, and expansion, 
your code does not need to deal with these cases. With these 
exceptions, your ccxle should handle any equation chat the 
Graphing Calculator can handle. 

You may allocate any amount of dynamic storage up to 
20MB, prfivided you deallocate the storage before returning. 'ITiis 
will be a native PowerPC Challenge, using the OxleWarrior 
environment. Solutions may be coded in C, C++, or Pascal, 
limited use of assembly language is also permitted, for anyone 
who might need it to acee,ss any dynamically generated code as 
part of their solution. Tlie solution computing the correct resulls 
in the least amount of time will be the winner. 

Three Months Ago Winner 
Congraailations to Jeff Mailett (Boulder Creek, CA) for 
prcxiucing the winning entry among ten submitted for the 
Othello Cliallenge. Tlie ol)jeaive was to win a round-robin 
Othello tournament, generalized to allow a board size between 
8 and 64 (even numbers only), by as large a margin as possible, 
using as little computation time as possible. Toomament points 
were based on the margin of victory (the number of die winner’s 
pieces showing at the end of the game minus the number of the 
opponent’s pieces showing), and on die amtmnt of computation 
time used, as follows: 

[margin of viciory - seconds of execution lime / 30] / number of squares 
The lest cases included board sizes of 8x8 and 18x18, with 
each player competing against each other player twice, once 
playing first, with the black pieces, and once playing second, 
widi die white pieces. I had planned to run some larger cases, 
but the first two still had not completed after running all niglu, 
Ml T had to stop at 18x18. 

The solutions submitted varied considerably in 
complexity. JTie simplest (and fastest) solutions assigned 
values to each board position and made the move which 
maximized total value. Some solutions took that approach 
one step further and evaluated an opponent's potential 
re.sponses and used a min/max approach to select the best 
move. Other solutions took credit for the number of pieces 
flipped on a move, with possible comsideration for 



Why develop your networkinti applications in the dark? 

Use EtherPeek Lite, Ethernet protocol analysis software, 
to test and debug your software and hardware communica¬ 
tions in minutes instead of hours! 

• Check for protocol compliance, 

• Use hundreds of built-in 
decodes. (IP, fFve. IGRR 
Netware IPX/SPX, NetBEUI, 

NetBIOS. DECnet. AppleTalk) 

• Develop custom packet 
decoders. 

• Filter packets during or 
after capture. 

• Test device reactions to 
specific packets. 

• Customize or alter 
packets for transmission. 

• Generate traffic to test 
varying loads. 

• Write your own plug-in modules. ^ 
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Mention This Ad For Your Special 
US S399.00 EtherPeek Lite Price. 

CALL: 8D0/466-AQGP or (1)510/337-7900 
FAX: (1)510/937^2479 

EMAIL: e})lite>t!tfo@aggroii|i.c;am 
WWW: !iltp://w ww. aggro u p.com/8 p I if e/ 
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Features 


Create a working GUI element 
with just 1 line of code! 

■JlJUJiJ I'JUii UJ 


Get extraordinary results using ordinary C C-i-4 or Pascal. 
Only 170 core roulines {about 370 total) replace the need 
for thousands of Toolbox routines, and thousands of lines 
of code. Tools Plus has you covered with... 

• Windows (illI kinds, uulo-|Josilk>mrtg) ■ Tool t^r 

• Cursors (cn! Of, fiTii mg lion. ?i.i to i^thiinge) * Floating palettes 

• Stroll liars (speed eoiilrd, live siirollingj • BuUons ftitl kir^si 

• Fktu re bultoi^s (the best anywhere) • listboxes 

• Makes CDEFs & LDEFs work automatically • Pop-up menus 

• Panels (3D, fiat, many options^ * Clipboard 

• Menus (puft-Llown and fiierarcbital) * Dynamic: alerls 

• Editing fields (w/seioli bans and fillers) (no resources rett'd) 

• Edit menu (auto^itlng with undo/redoi • Autoinatic event 

• Full color and multi-monitor support haudliog 

■ World-class custom buttons and sliders • and much more! 


One line creates it. One line makes it work. 



E^sy to l^arn 


E^sy to uso 


Runs quickly 


Ne^ds little disk space 


Needs little memory 

ijTfii 

Safer than toolbox routines 


Not just a different look 


No royalties 



T+ 3.0: — 
OC/C++ 
O Pascal 
® 6 otfi 


( -°A_J 

I ° I 
I 


SuperCDEFs” 

■ lUnriH^rtocc Controls 



only $89* 

*Free with 
purchase d1 
Tools Plus 
□evelapcr Kit 


World-Class Controls 
for Itie Discerning Developer 

Tcir al! M.k inkishc-s arifl system version^ 

Full etilor ,md mulh-niOMilor ____ 

bfiOxtJ, Powe rM^^c a i^d Fat/ 5 afe f ormal _ _ 

I \w finishing loti eh for ,1 coTnjiieie 3 0 i^k_ 


✓ 7 built ins, lahs ntiri 11 sUfiers (nat/JI-> text, 

fLiini > r.iisetl/inset tide, suft/liold slvidows, 

variable shafies) jiUis iht^Tiiomeier 

✓ Cusinmizable irhoik boxes plus unddinetl SWU* 

Sliders opilons: lick marks (1 sldc^none), 
sr.de (fiM warcl/rt^versefl/no'^c), sn*ip or step lo 
mouse, smart scaling 


0 Raid 
0 Slick 
□ Rauin’ 

O NIC® 
I® Hot 
O Cool 



Software 


2441 lakeiJiioire HoaH 
Box 70022 
Oakvilk, Otilarlu 
Canada LGLOMQ 
Phone: (41ft) 219-S62(t 
fax: (flO.'J) 047^1 ft30 

t'lTiiiftl: Vp^terEdjjSVVi^'fltit.toiTi 
111 lp://Wwi/v.inter1o|L‘.c(mi/-Avalei edig 


Tooli Plm for 

Syiminlet (THINK) C/C++ $149 
THINK Faecal $149 

T HIN k C/C++ & Pascal $ 199 

CodeWarrier Bronze $199 

CodeW'.ifrjcr Gold $249 

(We VISA (iFid AnK'X. 

Atid’StOlur slilijplnK.i, 
“Call Jor Acaijenqjc jjriLing^ 


Free Evaluation kit: 
Availalile on AOL, CIS, 
iMlernelaiiKl al our 
weti aile 


★ ★★★ 


Macworld, Fel )’96 


vulnerability to reversal on the next move. The winning 
solution used the most complicated approach, with lines of 
play being examined by a progressiveiy deepening search. 

The table l:)eIow describes how each player fared against 
each other player. Hach row shows the number of victtjries that 
player had against the player represented by tlie corresponding 
column. The final column shows the total number of victories 
won out of the 36 games played by each entry. As you can see, 
the secontl plac:e entry by Randy Boring won nearly as many 
games as Jeffs winning entry, and actually beat the winning 
entry in one of the four games they played. 


Playier Name 

1 

2 

1 

A 

5 

& 

7 

e 

9 

10 

Wins 

1 David Wliitney 


1 

4 

2 

4 

2 

2 

0 

0 

4 

19 

2 Farmer 

3 

- 

4 

2 

4 

4 

4 

1 

0 

4 

26 

3 l>avid Mtliavon 

0 

0 

- 

2 

4 

1 

] 

0 

1 

1 

10 

i line. 1 iaiiRsiefo 

2 

2 

2 

- 

4 

0 

1 

0 

0 

3 

14 

5 Ken Siczak 

0 

0 

0 

0 

- 

0 

0 

0 

0 

0 

0 

6 Cregory Ccxiper 

2 

0 

3 

4 

4 

- 

2 

0 

1 

4 

20 

7 Mason lliuinas 

I 

0 

3 

3 

4 

2 

- 

0 

0 

3 

17 

S Randy Bormg 

i 

3 

4 

4 

4 

4 

4 

- 

1 

4 

32 

9 JcfFMallcn 

4 

4 

3 

A 

4 

3 

4 

3 

- 

4 

33 

10 Lutbvk Nioille 

0 

0 

3 

1 

4 

0 

1 

0 

0 

- 

9 


The top two entries used significantly more computation 
time tiian die odiers. Jeffs winning entry used an average of 
more than one second per move fas you can see by examining 
the parameter settings in his axle), bin ilie larger margin of 
victory more Uiao offset die execution time penalty. 

The table below provides the code and data sizes for each 
of the solutions .stibmitted, along with die total number of 
victories won in all of the test cases, and the cumulative score 
earned in those victories. Numbers in parenthesis after a person's 
name indicate that person's cumulative point total for all 
previou.s Challenges, not including diis one. 


Player 

Code 

Data 

Wins 

Score 

jeft Malicit (44) 

fi98« 

277 

33 

25.49 

Kandy liorin); (27) 

6908 

64 

32 

20.37 

Gregory Ctxiper (27) 

m 

2^44 

20 

15.00 

Dan Farmer 

9240 

% 

26 

14.27 

David Wliiincy 

7216 

864 

19 

979 

Eric 1 langstclei 

4124 

m 

14 

9.72 

Ma.son ntoiTias (4) 

6976 

57 

17 

y.ui 

David iMtOavTjn 

327Z 

48 

10 

8,09 

Ludovic Nicolle (21) 

6436 

120 

9 

6,33 

Ken Slczak (20) 

9256 

77 

0 

0.00 


SaMPU; GaML 

Here is one of die games played by the top two entries. Randy 
Boring's entry played Black, and jeif Malletfs played White. 'I'he 
moves are given as the row and column selected by the progranris, 
interspersed with an cx:casional view of tlie resulting Ixiard position. 
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Move 

Black (Boring) 

White (Mallett) 


row 

col 

row 

col 

1 

2 

3 

4 

2 

2 

5 

2 

2 

4 

3 

2 

5 

3 

5 

4 

4 

5 

3 

6 

5 

2 

2 

3 

2 

6 

2 

6 

5 

3 


Ulack's next move, to (0,1), prevents Wliite from oOtainin}; 
a foothold on one of the edges. 


14 

15 

16 

17 

18 

19 

20 


0 1 

3 0 

1 0 

5 1 

0 4 

6 0 

1 4 


2 1 

2 0 

5 0 

6 3 

4 0 

7 2 

1 6 


- - B B B B B - 

- - W W W B W - 

- ■ W W B B ' - 

- - B W - * * - 


7 3 1 

... mLs.sing an opportunity to place a piece on the edge at (2,7), 
inviting (1,7) as a response by white, in hope of moving to (0,7) 

5 4 

8 4 1 15 

9 3 7 


B - B B B B W B 

BWBBBWWB 
BBBUfiBWB 
BBWWBWW- 
B B W W W W - - 

B - W W - - - - 

- - W - - - - - 

While white had other choices, none of them were very good, and 
this move to (1,6) gives Black a corner on the next move. 

21 0 7 6 1 

22 7 0 


.W - - 

- - B B B W B - 

-BBBBBBB 

- B B B B W - - 

- - B W W - - - 


Black occupies the first edge square. 

2 7 

10 17 13 

11 12 4 6 

12 0 3 5 5 

13 6 2 0 2 


- - B W * W - B 

- - B B W W B B 

- B B W B B W B 

- B B W B W W - 

- - B B W W * - 

- - B - - - - - 


Black takes a second corner... 

- B B B B - - B 

B B B B B R B 
BWBBBBWB 
BWBWBBWB 
B W W B B W W - 

B W B W W W - - 

B B W W - - - - 

B W. 

7 1 

23 7 3 7 4 

24 6 5 6 4 

25 7 5 6 6 

26 7 7 

... and a third ... 

- B B B B - - B 

B - B B B B B B 

BWBBBBWB 
BBBWBBWB 
BWBBBBW- 
B B W B B B - - 

B W B W W W B - 

B B B B B B - B 
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Available from Ibe MacTech Mail Order Store 


De mo/inf 0 : http: ram pages, onranip,nct/'-stcpti p 


$99 


Guide Gofinpowi n irwJenirtrk of Sie^iUp Soft^vaw- Apple Gwde i* ii irjdemufk of Apple Coitiihiiot, Inc. 


STEP”’* 

SOFTWARE 


7110 Glendora Avenue 
Dallas, Texas 75230 
214-360-9301 
214-360-0127 fax 


27 7 6 

28 1 1 


5 6 

6 7 


Black wins by a score of 37 to 27, a relatively close game 
compared to many in the toiiimment. 


B B B B - - B 

BRBEBBBR 
B B B B B B W B 

BBBWBBWB 
BWBBBBW- 
S B W W B W W 

BWBWWWWW 
BBBBBBBB 

Black could have done heUer vvilh (5,7) al this [X)inl, instead t>f 
giving the final corner to White. 


29 

4 

7 

00 

57 

30 

- 

- 

05 

31 

0 

6 



TOP 20 CONTESTANTS 

Here are the poiiil totals for the I'op Contestants in the 
fJrogrammer's Challenge, I'he numbers below* include points 
awarded over the 24 mo,si rec'cni contests, including points 
earned by this mt>nLb\s enLninLs. 


Rank Name 

Points 

Rank Name 

Points 

L 

Munter, Ernst 

IH-l 

11. Cirlts, Kevin 

21 

2. 

Gregg, Xan 

114 

12. Nicolle, Ludovic 

21 

3, 

l^ar.sson, Gustnv 

47 

13. Picao, Miguel Cniz 

2t 

A. 

Lcngycl, Eric 

40 

14. Bixjwn, Jorg 

20 

5, 

Boring, Randy 

37 

15. Gundrum, Eric 

20 

6, 

Cooper, Greg 

34 

16 . Higgins, Charles 

20 

7. 

Lewis, Peter 

32 

17. Kasparian, Raffi 

20 

8, 

Mallctt, Jeff 

27 

18. Slezak, Ken 

20 

9. 

Antoniewicz, Andy 24 

19. Snider, Thomas 

20 

10. Beith, Gaty 

24 

20. Karsh, Bill 

19 


WWWWWWBB 
EWRBWBBB 
B B W W B W W B 
BBWWBWBB 
BWBBBWBB 
BBWWBWWW 
BWBWWBWW 
BBBBBBBB 


lliere are three ways to earn points^ (1) scoring in the top 5 
of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) iKang the first person to 
sSUggest a Cliallenge that I use. The points you can win are: 

1st place ........20 points 5th place ... ..2 points 

2nd place.10 points finding bug.2 points 

3rd place.7 points suggesting Challenge,..2 points 

4ih place. 4 points 
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StoneTable Break on through the limitations of the List Manager 




i: 





John Smith 


Home;;' 


3224 NE 58th Avenue 
P.O Box 12665 
Portland. OR 97212 


68 & PPG libraries for Think C, CodeWarrtor C & Pascal, MPW C & Pascal $200.00 


Includes PowerPlant Class for CodeWarrior 
International shipping (US Airmail) $10 
No royalty fees for applications 


StoneTablet Publishing 
P.O, Box 12665 "Tt 
Portland, OR 97212 
voice/fax (503) 287-3424 
stack ©teleport,com “t-’ 

I +4 rr4^ ^ 


Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 
set font, size, fore/back color, face, alignment per ceil 
cell margins, top/bottom & left/right 
drag cells in and between tables 
edit cells in place 
popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 
PICT's and controls in cells 
“LDEF-like" custom drawing function 
greater than 32K data per table 
plus all List Manager functions and more 


More Info - http://www.telepoi1,com/"'Stack 

Demo - ftp ://ftp,teleport.com/pub/vendors/stack/StoneTableDemo-hqx 


New Price 
New Version 


Here is Jeffs winning solution; 

*Jello.c An nxn Othello program in C 
* Copyright 1997 Jeff Mallett 

/* 

^ IJjics stardi with iiemtivt tntnspositioa labks. 

* (TJitensicm fur .sotvini?. fiitilitv a Jitmplistk! selectivity, etc, 

7 

llflnclude <stdio .h> 

#inciude <stdlib.h> 
ffiuciude <tiifte.h> 

^define HY ASEElT(b) 


Engine Parametc'rs 


// ExtLiUiioiis/PnihLng 

#defihs kiiull Depth Flies 2 //# of ftiU-dcpdi pht-s bcfmc'selectivity 

fMetiue kKolveThteshold 4 //Ptics extension for wilvjiig wliuk Ewart! 

^define kMiniuiujoSafeDisks 3 //Minimurn disb to have and still be siifc 

ffdefine kFntilityScore kCoriier 

// ficorc above beta to trigger futility aiHJff 
Ifdefine kUi ppCJutExte-ns 1 nn 2 

if Exietvd a ply if opporteni doesn't have more disks than this 

//Avemge move time in bOths of a seeojid 

^define kOpeningHaveTime 50 //In Llic opcJimg 

#define kMoveTime 150 //iNoraially 

//define kSolveHoveTirae SOQ //When trying to solve 

//Scoring I^rameters 

//def f ne kF i na 1D! sk 5 0 // per disk on hoard at the end 

f/cl e rin 0 kToo FowUi s kn 50 // per d isk iintler th reshoUl 

Constanis/Macros 

//define klnfinity IIOOOGOOOL 
jfdefine kBestPossible lOOOOOOOOL 

// [>intfctl<ms (if se incfcases both x and y): 

//? 0 5 13 2 1 (1 

//NBSWNWSE S W E (opposites arx-adjat cut) 
enmn ( D1K_E = 0, Bmjfi, D1R_S, 

DIR_SE. DIR_NW. DIIL_SW, DIR_NE h 


enutn [ E “ 0x0001, 

U = 0x0002, 

,S = 0x0004, 

N - OxOOOE, 

SE = 0x0010. 
m = UxOOZO, 

SW OxOD40, 

NE = 0x0000. 

E BORDER - 0x0100, 
W BORDER = 0x0200, 
S.ftORDRR " 0x0400, 
N^dORBER - 0x0800, 
SE_BORDEH = 0x1000, 
NW 30 RDER = 0x2000, 
SW_B0RBER - 0x4000, 
NE_B0RDER * 0x8000 


//Array' of sqiiiares on the l'M>a!irf (up to 66 x (»6 sc|iiares) 

// Eadi squart^ has: 

// Isl 8 bits III this direction theiv’S a BIACIK disk that can be flipped by WHFl't 
//define ADJACENCY 0x0 OOOOOFF // Adjacent to disk in 8 diitctions 

//define B0RDER„AEJACENCY OxOOOOFEOO //Adjacent tu border in B diitctioas 
//define WHITE 0x00010000 //Is White disk here? 

//define BLACK 0x00020000 //is Black disk here? 

//define COT,0R_BTT.S 0^00030000 //Mask: Is disk here? 

//define BORDKR_HIT OitOOOAODOO //Is this bcmler square? 

//define COLOR_BORDKR_BlTa 0x000 / OOOO // Mask: Is boitlcr ur disk here? 
//define BAD3IT OxOOOBOOOO //XorCsquare 

//define EMPTYAOJ_BITS OxFFFOOOOO TTop 12 bits (tM0<>5) V 


Jfdefine BORDER ADJACENCY SHIFT 8 
//deUne COLOR SHIFT 16 
^define FMPTYADJ^SHTFT ?,Q 


^define 
//define 
//define 
//def ine 
tfdefine 
Irief j ne 
//dn f ine 
//define 
//define 


lS_NOT_EMFTY(z) {(z) & C(JL0R_B0RDER_B1TS) 

IS_EHPTY iz) \ 1S_N0T^EMPTY {z) 

RAS_DISK(z) iiz) St COL0R_BITS) 

HAS NO DISK(z) !MAS_DISK(z) 

IS BORDERCz) iiz) St BORDER_BIT) 

TS^ON BOARD(z) !IS BORDER(z) 

TS.RAOtz) ((z) k BA0_BTT) 

lS_El>GE{z) (tz) k B0RDER_AL)JAGENCY) 

lS_C0RNER[x) tgCountZero£[({z) k BORDHK^ADJACKNCY) \ 
» BORDER_ADJACENCY_SHIFTj = 3) 
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^define OF PON ENT {si ((side) COLORJITS) 

^define y) Hy) * gReal Board Size + M) 

i^define COUNT mmES(z) \ 

gCountZeros[ C(z> | {(z) » \ 

BOHnFpR_Ar)JACKNCT_SHTFT)) & ATUACKNCY ] 

Ifdefine OllLBiT(dirl ClL « (dlrj) 

HeUns 0PP_D1R_B1T Edir) gOppMrBit Idir] 

^define EMPTYAOJ^ITCiadeji) \ 

({index) « EHFTyADJ_SHlFT) 

JfdefJna OKT.RMPTYADJ TNBEK(pSq] \ 

CEpSq) » EMPTYADJ^SHTFT) 

^define SET_BNPTYADJ^INDEX(pSq. index) ^ 

'(pSq) ^ {^(pSq) h '‘EHF'nAOJ^iTS) | EMFT¥ADJ_H1T{index) 

//Add lociid of iisi 

fMeflne ADD_TO_EHPTYADJ(pSq) \ 

SET EMPTYADJ INDEX(pSq, gSizeEmptyAdj): \ 
gEmptyAdJ[gSlzeEmptyAdJ’Kl = pSq 

// Swup entry in list ixitli eml entry ainl stirink M 
#deflne KEMOVE_FROM_EKmADJ{pSq) [ \ 
long 1 ^ GET_E«P'rYADJ_lNm(pSq}; \ 
unsigned long *p "= gEmptyAdj j-gSizeEicptyAdjJ: \ 
gEmptyAdjlil p; \ 

SET EMPTYAUJ INDEX£p* i): \ 

1 

^define PUSH(x) * ^gChanfiesF.nd^^-) - (x) 

^define START_SAVE FUSlUOU 
i^define PUSa^SOCpSq) \ 

I PUSH(*EpSq)): PUSH{(unsigned long)(pSq)); ) 
{define POP *(-gChangesEnd) 

tfd e fine TOP •gCbange sEnd 


Static \^riahks 

// Direction indices 

GtaLtc unsigned long gOppDirRtl [S] 

( W. E. N* S* NW, SE* NE, SW ): 

// Ofistis on boanJ pJus /.era ^ntmd 
U Rll in when wc know board si/c 

static long gOffsetsHl - 1 IL*-IL . m,99L , 99L,99L,99L,99L,OLh 

// ^Squares — Army of squares: Sutre*: board 
gtaUc unslgtied long ^gSqimron: 

siaLic unsigned long * gOriBoardSlur L i //rimer into gSquares 
static unsigned long * gOnJioBrdKnd: //tYrimcr into gSqoarcs 

static long gNuatOnSquares t //# of )»qujirt‘s, not induding Nirdcrs 
Static long gRealBoardSize: // Ungih of a side (indudes ttoitlm) 

// gEmptyAd) — Army of ptrinters U) squares: 

// Stores ail empty squares adjacent tci disk(s) 
static PSQUARE ‘gKfnptyAdji 
static long gSizeEmplyAdj; 

// gChaiigcs — Array of unsigned longs containing data to undo moves 
// list of: 

// <p[}inLer to squaro <okJ square valuo 
// terminated by a t)L 

// The first pttsiiion will be the dnip square arul the others will be flips 
static unsigOBd lortg ‘gChnngeni 

static unsigned long •gCbnngosEnd: //Pointer into gf^iangcs 

// gfljutuZeros — l^tLcalcuJalcd 29(M:ltitKml cinnManl army 
// returns count of zero bits in the byte 
static unsigned long ^gCountZetos; 

// gTrcc — Array of prrinters to squares: Holds seart'h tree 

Binlie PSQUARE ‘gTrcct 

static PSQUARE ‘gTrceEnd: //Pointer into gTrcc 


typedef unsigned long * PSQUARE: 
typedef long SCORE; 


// gMiit>iliiy — Array of counts of iitin cs available at each ply 
static iong * Mobility; 


^define USE^HASH 
{ifdef USE^HASH 

{define kHasHTableMask 0x7FFF //32Kentn-table 
{define kttashTableSixe (kHashTableMank + I) 
{define kKwitehKideHafih 0x87654.121 
eriuin [ TNVM.T0 - 0, VALID K 

LDWKR_KOIJND - 2. UPPER.HOUNU = 11; 

typedef struct SHash I 
unsigned long HashVnlue: 

SCORE Score; 

PSOUARE BestHove: 

Bhort Depth; 
short Type: 

1 SJIash: 

static SHasb ‘gHashTable: 

static long gWhiteHashOffset, gBlackHasbOffset^ 
gPlipHashOffset; 

static unsigned long gHashValue; 

{end if 


Pn>tf>typcs 

Boolean /^kgalMovcV Othello £ 

long boa rd S ize, /* tiui 11 i>cr tjf n iwycolurnns In the game I«wtrtl'/ 

long oppRow I /’ row where opponent [m moved, 0 .. lKrand,Sizc-l 7 

1 0 ng 0 ppCo 1 * /• c(jlumn where t jpp^ment last rai wctiT).. l>oantSizc-1 V 

long * mo veRo«, r return your move ■ row t).. Ix^arelSizc-l 7 

long ♦ mo veCo 1» /’ ret u m your move' col umn, D ,* hcjqrelSiM' 1 7 

void * pr 1 w S10 ra ge. 7* prt*aikH“atrxl stooge for your use 7 

long siorageSizu> r size of pm-Sttioge in bytes V 

Boolean newCarae, /* TRUE if this is your first move in a new game 7 

Boolean playBlack /* THlil: if vou pliv finsi (black pieces) 7 


static ,^C0aE Search (SCORE alpha, SCORE beta* unsigned long 

ntde, long depth, Boolean passEndsGame): 

sialic long GeneraIc(unsigned long side); 

static SCORE HakeNove{FSQUARE to, unsigned long Bide); 

static void UnmakeHoveO ; 

Static void Initialize(long boardSize, void 'prlvStorage); 
static SCORE Evaluate{unsigned long side); 
static long SortValuefPSQUARE p, unsigned long side); 
static void BuhbleSorr(long n, unsigned long nide); 


// Ikiinters to various special squares 

static PSQUARR gNWCorner. gNWX. gNWCl. gNWC2; 

Sta tic PSQUAHE gNECarner, gNkX, gNKCl, gNEC2; 

static PSQUARK gSWCorner, gSViKn gSWCl, gSWC2: 

eutic PSquARE gSECorner. gSEX, gSECl, gSEC2; 

//'I Im: gCkmnus array holds curre nt counts of diska 
//Accesi Ls by gCkiunLs[si[k » <X)LOR SHJIT| 

// gO)uri(.s[^nTK_iNDEX] white's disks 
// gCounislRUCK INDEXI Nadi’s disks 
{define WlilTE.TNDKX (WHITE » C0L0R_SlilFT) 

{define BUCK^INDKX {BLACK » COUOR^SHIFT} 

static unsigned long gCouritsl3j ; 

static SCORE glncScore: // ,Scorc relative to side to move 

static SCORE gEndganeDi skBonus; //Ikmus per disk in endgame 
static SCORE kX, kC, kEdge, kCorner; //Penalties/Bomiscs 

Rl a M c 1 ong gAhn r i Sou rcbTi mo: //Tlmr at which rhe srarrh will be aborted 

G t a U e Bool can gAbnr t orl: // Has the st'areti been aboflctP 

static long gStartOepth; //Search was started at Ms depth 

static long gPly: //Numixr of movcN deep 


OdieJIo 

Booloun /HegalMoveV Or hollo ( 

long boa rd,S 1 ze, /“ numlxT of rows/cr>himns in the fpmte board V 

long oppRown r row where opponent last moved, 0.. boardSizc-l 7 

long oppGol, r OJlnnin wIktc ujvjxjiKiU Ltst m(M.-d,D boar^izc-l 7 

long 'moveRow, T return your move row. 11 „btKitdSKC-l 7 
long ‘moveCol, /* rcium your move - atlumn. (I « bourelSizc-1 7 

void *p t ivStorage, P prcalloeaied storage ktr your use 7 
long storages I ze, p size of privSioragc in bytes 7 

Boolean n ewGame, P THl IF. if 1 bb b your R rsl move in a new' game 7 
Boo lean playBlack P TRUE if you play first (blatii pieces) 7 


PSQUARE p: 

unsigned long side ^ playBlack ? BLACK ; WHITE; 
unsigned long nextSide; 

SCORE t, bests CO re, savelncScore ; 
long J, generated, index, x, y: 
lung sLlllOpcn, bcjJlFoundAl, ’pOffsels; 
long startTiae, targetTlme* tatgetUuration; 
Boolean naatEdge; 
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tflfdef USE_HASH 

utisigned long sflVfiHashValne: 

#endif 

if (newGame) i 

Initiali^e(boardSiize, privStorage); 

I 

gChangesEnd ^ gChanges; 

#lfdi>f USE^HASH 
// Fix up gHiujhTabk' 
t 

SHash ‘pHashTable “ gUashTable: 
int i: 

i " kflanhTabieSize - Ij 
do I 

(pitashTabto++J->Dnprh -- 2; 

1 while (13; 

J 

(fendif 

if (oppKow t" ‘1) { 

index - XY2INDEX{oppCDl+l, oppRov^^l) r 
gTncScore -= 

HakeMove {AgSqua re t Index], playBlack ? WfllTE ; BLACK); 
gChangesMud * gChangos; 

J 

gTreeEnd - gTree; 
generated ^ Generate(side); 

ir (Igenerated) I //Namm^ 

'ttoveRow • ‘moveCol “ -1; 
return TRUE; 

I 

If (generated > 1 I (newCame && oppRow ~ D) I 
BubbleSort(generated» side); 

gKobilityfOl = gMobilityfl] = generated: 
gPly - I; 

nextKide - ORt’QNKNTCside): 

stillOpen gNumOnSquares gCuunis[WHITE_TNnKX] - 

gCounU[HLACK_™KX]: 

// CHltdatt’ gE^d};amcl>bldk>nu^ 
gKndgameBiskBonus * 0; 

X * gNnanOnSqnares / 3: 
j = K St til Open: 
if (j > 0) ( 

g£ndga&ie111skEutins (j * kFJnalBlsk) / {x * 5); 

it (1 gEndgameBlskBonus) 
gEndgameDiskBonus “ 1; 

1 

// i>n wc ha\T any pieces near an edj^c? 

near Edge false; 

for tp " gPnBoardStart: 

InearEdge p <=^ gOnRoardEnd; ++p) I 
if CHAS^DlSKCp)) I 
if (IS3DCE(^p)) I 
nearEdge ^ true: 

) else ( 

pOffsets = gOffsets; 
do I 

If {TS_F.0GK(*fp + •pOffnp.ts))) 
nearEdge " ituei 

) while [! nearEdge fir& * (++iyOIfseis)); 

I 

\ 

1 

// Set limes 
if (InearEdge) 

targetDuraiiou = kOpeningMoveTime; 
else if (stillOpen > 20) 
targetDuration ** kHoveTime: 
else // try lo salvel 

targetDuration kSolveMoveTirae: 

RrartTine = LMGetTicksO ; 
targetTiiie “ ntartTlme + targetDuration: 
gAborLSearchTiire ” startTime + targetOuration * 6; 
gAborted * false: 


savelneStore = glncScote; 
l^ifdef GSE_HASH 

saveHashValue == gHash Value: 

Ifendif 

for (gStartDepth=l: gStartDepth C stillOpen IgAborted: 

++gStartDepth) I 

to = gTree; 

bestSeore = kinrinlty: 
for {j=0: j<generated; ++j) I 

gIncScore ^ - (gIncEcore + HiikeHuve(*lo, side)): 
ftgply; 

t ^ -Search('klnflnityt klnflnity* nextSide^ 
gStartDepth ^ 1 h false): 

gPlyi 

UnoiakeMove () : 
glncScore = suvelncScore: 

^Hfdef USE_HASH 

aHasbValue = saveHashValue; 

#endlf 

If (gAborted) 
break; 

if (t > besiScorc) I 
PSQUARE bestHovet 'p: 

// Move "to to from of the tree 
bestHove ^ *xo: 

HY ASSERT(bestHove gOnfloardStart beaLNove <= 

gOnBoardEnd): 

for (p to; p I- gTree; -p) 

*p - ‘(p-1): 

*gTree = besiMove; 

bestScore = t: 
bestFotmdAt = gStartDepth: 

) 

If (LMGetTicks() >= targetTine) I 

If (bestScore > -kinfinity gStartDepth + 

kSolveThreshold I 1 stillOpen) 
break: // time to stop 
It (LHOetTickaO - ^tarLTime 
>- 3 * targetDuration) 
break: //time to stop 

1 

-H-to: 

I 

if {gStartDepth >= 4 H LMGetTlcksO * startTime > 1 + 
ta rgetDuration/2) 

break r // probably not enough iimc to finish anoihcr irmtion 
if (gStartDepth * bestFoundAt == 3 
U IS,CORNERt*gTreelOj)) 
break: // cas>' mmer movt 
I 
I 

gIncScore ■»= MakeMovet'gTree * side): 
index (long) ('gTree - gSquarea): 
y “ index / gReslBoardSixe; 

X Index - y * gRealBoardSize: 

'moveCol = x - 1: 

'lOOvcRow =" y ] ; 
return TRUE: 


fkiftVblue 

// Returns value that orders squares for ftjot scaroh 

long SortValuEfFSQUARE p, unsigned long side) 

I 

long sllllOpen, value; 

PSQUARE q: 

unsigned long occupant. enemy; 

long 'pOffsets: 

ff (IS_HBGE(*p)) I 
if (TS_CaRNEEf*p)) 
return 200; //Corner 
if (1 S_BADC"p)) 
return -ICO; //€ 
return 100; //Edge 
J 
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If (lS_BAi>C*p)) 
return -ZOO: //X 

// Check p's adjaccnc) hits 

StillOpen “ gNuiOnSquarefl - gCotints [WlllTE_INDEXj - 

gCountslBUClCJNDEXl: 

enemy “ OPPONENT (side): 
val UP 0: 

pOffsGts ' gOffsetsi 
do t 

q - p + *pOftsets: 
occupant = "q & COLOR BITS: 
if (stillOpen >10) I 
if (occupant *■ side) 

++va 1 ue: // good to take awa)’ empt)-adpccni 
else if (occupant = enemy) 

-valuer // had to flip 

] else if (□ccupant ^ OPPONENT(aide)) 

++value; // endganie: good to Hip 
I vhile (*[f+pOffsets)): 

return value: 


BuhbleSort 

// Sons generated root moves in decreasing \'iLue ofder 

// Hey bubble sort is really okay in this case 

void BubbleSort(long n, unsigned long side) 

I 

long i, j. $waps: 

PSOIIARK terap; 

for (J“n-2; j>=0; -j) I 
swaps - 0: 
i = 0: 
do i 

If (SortValue(gTreeEi+l), side) 

> SortValuetgTree(i], side)) f 
++sv3pa: // Swap i and i+1 
temp = gTree[1j : 
gTrealij gTree[i+l] : 
gTree [i+1 ] “ temp: 

) 

[ while {i++ 1= j): 
if £ I swaps) 

break; // Alnrady soned: HtiisJi early 
I 

1 


Evaluate 

// Hvjiluaic iwsition and return score refcnive to side 
H side is aiso the side to mwe 
SCORE Evaluate(unsigned long side] 
t 

SCORE acore = 0: 

// MaaimiKc dbb, bui in endgame 
if (gEndgmneDiskBonUa) I 

score - (gCounts[WHITE INDEX) - gCounts[BLACONDEXJ) ‘ 
gCndgameDiakBonua; 

if (side “ BLACK) 
score = -score; 

1 

// NW Comer Area 
if CUAS_DISK£‘gHWCorner)) t 

score +^ (*gNWGorner % side) ? kCorner ; -kCorner: 

] else if ("gNWCorner h ADJACENCY) I 
If (HAS_0TSKCgNWX)) I 

score +- (VgNWX h side) ? kX ; ‘kX: 

I 

if (]IAS_DISKt*gNWCl)} I 

score ^ (*gNWCl B side) t kC : -k€: 

I 

If (HAS.DISKCgNWCa)) I 

score t= [*gNWC^ £* aide) ? kC t kCt 

I 

I 

// OinKT Aren 

if (HAS_DISKfgNECorner)) I 

score +^ (‘^ECornet & side) ? kCooier : -kCorner: 

I else if (*gNECorner h ADJACENCY) 1 
if (HAS DISKCgNEX)) | 


score C*gNEX & side) 1 kX : -kX: 

I 

if (HAS^DISK(*gNECl)} I 

score += CgNECl A side) 1 kC : -kC; 

1 

if (HAS_aiSK(‘gNEC2)) ( 

score += (*gNEC2 & side) 1 kC : -kCi 

I 


//SW Coma: Area 

if (HAS.DISKCgSWCqrner)) t 

score ■+=" ('gSWCorner & side) 7 kCorner : -kCorner: 

1 else if CgSWCorner h ADJACENCY) £ 

If £lIAS_DlSK£*gSWX)) I 

score +- t*gSWX & side) ? kX : -kX: 

) 

if (HAS_DISK(‘gSWCl)) I 

score +=" (*gSWCl k side) 1 kC ; kC; 

) 

if £EAS_DISK£*gSWC2)) I 

score (*gSWC2 & side) ? kC : ^kC: 

) 


// SE Comer Area 

if tHAS_BISKC*gSBCorner)) ( 

score += (“gSECorner fir side) ? kCorner : *kCorner: 

] else If (*gSEComer & ADJACENCY) I 
if (HAS^DISKCgSEXj) f 

score +“ {*gSEX side) ? kX : 'kX; 

if (HASJISKCgSECD) I 

score +“ ('gSECi & side) ? kC : kC: 

J 

if (HAS_DTSK(*gSEC2>) 1 

score += (»gSEC2 & side) ? kC : -kC; 

1 

1 

//Tou few disks? 

if tgCounts [WHITE.INDEX! < kMitilnuitnSafeDlsks) I 

SCORE X = (kMlniffluraSafeDisks gCourits[WlJlTlLIND£Xl) 
kTooFewDisks: 

score +- (side = WHITE) 7 x : ’x * 2: 

1 

If (gCounts[BLACONDEXj < kNinimuiBSafeDisks} ( 

SCORE X “ (kHinimuniSafeOiskE - gCountsfBLACK_THDEX)) 
kTdoFewDifiks: 

score (side — BLACK) 7 x s x * 2\ 


// Mobility 

score += gMobility[fiPiy-2] “ gHobiJityIgPly-1): 
// Could also have a value for the right to move 
return glncScore 1 score: 


SCORE Search(SCORE alpha, SCORE beta, unsigned long side 
long depth, Boolean passEndsGame) 

register PSOUARE ’to: 
unsigned long nextSlde: 
long generated; 

SCORE t, bestScore, savelncScore: 

PSQIJARE ’firstHave: 
long StillOpen: 

SCORE oldAlpha = alpha: 
tfifdef IISE_HASH 

unsigned long saveHashValue; 

PSOUARE bestMove, tableReply; 

SHash ’pHashTable: 

Ifendlf 

StillOpen gNumOnSquarefi ^ gCounts [WHITE.IHDEXl - 

gCountS [BLACK INDEX] ; 

if (IStillOpen) £ 

// Uoanl full 

bestScore ^ (gCounts[WHITE.INDEX] 

gCounts[BtACK_INDEX]) * kFinalDisk: 
if (side -- BUCK) 

bosLScore ” bestScore: 
return bestScore: 


Search 
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f 

if t!gCounis[WHlTE_rNDKX]J { 

// White Ls wiped out! 
bestScore “ kflestPossible; 
if (side = WHITE) 

bestScore = -kBestPossibie; 
rftturn bestScore: 

J 

if (lgGounts[BLACK_INBKXl) I 
// Bbick wiped out! 
bestScore = jdiesiPossible; 
if (side — BLACK) 

bestScore ^ -kBestPossible; 
return besrScore; 

I 

if (depth (= 0) t 

if (stillOpen > kSoIveThreshold hh 

gCountslOPFOHENTtalcle) » COLOR_SHIFT] 

> kWipeOutExtension) \ 
bestScore - Evaluate(side): 
i^ifdef USE HASH 

hestHove NtILLs 

^^endlf 

^oiQ HaahSaver //Terminal mxk 

I 

I else if (depth = 1 && stillOpen > kScjlvoThreehold) 1 
t “ Evaluate(side): 
if (t y beta + kFutilityScore) 
return t; //FutUin cut-off 


#i£def USE^UASil 
tableReply = NULL: 

pHashTabie igHashTabletgiiashValue ^ kllajihTableMaskl i 
if (pKashtable->HashValue “ gllashVaiue) 1 
tahleEeply = pHashTabie'>BestMove; 

If (pHashTable‘>Depth depth) I 
if (pHafihTableOType — VALID) I 
If (pHastiTabI«=!-)Krore > beta) 
alpha = beta; 

else if (piJashTablo ^Scorc "> alpha) 
alpha = pHashTahle >Scorc^ 

1 else if (pHashTable >Type — LOWEB.BOUND) I 
if (pEashTabie Hcore > beta) 
return beta + 1; 

I elfse if {pHaahTahle^>Type — UPPER_BOUNB) I 
If (pEanhTah1e->Si^OTe < alpha) 
return alpha 1; 

if {alpha > beta) 
return beta; 

I 

I 

i?nfidi f 
//AtHlfT? 

it {LMGeiTicks() >-^ gAbortSearchtimn) I 
gAbotted = true; 
return D; 

I 

//tfdef !ISK HASH 
boulMove * NlllJ^i 
#enil ] r 

(lextSldu = OPPONENT (aide): 

firstNove = gTreeErtd: 
generated = Generate(side); 
gMobllltyfgPlyl ^ generated: 

if (igenerated) I //no rmwesavaiUblc 
If (pussEndsGame) I 

beat Score - (gCouiiL a IWIlTTR^TNDKXj - 

gCounts [hLACi(_INDEX 1) * kFhinliHnk: 
if (side — ILACK) 

bestSeore ^ -bestSqore: 
returti. be St Sc ore: 

I 

#ifdcr IJSK^HASH 

ghutjhValue kSwiirbSidcHafib; 

/fend if 

glncScore ‘glncScore; 



RoySl CleverTools 

Softv\/ 3 n 0 Clever People!™ 

Inc. 

Over 50 Powerful Tools For 
HyperCard, SuperCard, OMO, and AppleScript! 
Including: 

LiveCard: Run HyperCard over the Internet! $99.95 
TCP Suite: FTP, SendEmail and GetURL $99.95 

MegaWindow: External Windows were never easier! $79.95 

QTCX: QuickTime conferencing $99,95 

PrintReport: Print and Preview sophisticated reports! $79.95 
Compilett!: Hypertalk compiler - Create any code resource! $49.95 

Satisfaction Guaranteed! A leader since 1984! 

Get 1 0% off your order [20% off orders over $200!] 
by mentioning this ad! 

Royal Software, Inc. 

300 Cedar Lane Jr 

Largo, fl 33770 

800*888.7667 sales 

813*581.6422 voice ^ 

813.559.0614 fax Including 

salts@royalsoftwarexom Heifer 

http://www.royalsoftware.com Software 

Find oui why Apple bundled ore of our products with the Eatest release of HyperCard and 
CEO Amdk) iTienlioned us by name at his keynote speech at MacWorlo SF W 



4-+gPly; 

bestScore = -Searcht beta, ulpha. 

nextSlde, depth, tmel; 

-gPly: 

gTneScore = -gIncScore: 

++deptb; 
goto Searched; 


to == flrstHove; 
bestScore - klnfinity; 
ififdef USE_HASR 

if (tflbleReply fah “to J*- tableSepiy) I 
// Rnd tableReph^ in move M ami move lo from 
PSQUARE ‘p; 

iot (p = Lo +1; ’p: +fp) 
if (*p ™ tabloKcply) 1 
// Swap > and ho 
*p “ *to: 

*to ^ tabieReply: 
break: 

I 

I 

ffendif 

saveIncScore = gIncScorei 
Ififdef USE.HASH 

gHashValue kSwitchSideEash; 
saveHushValue = gHashValue: 

/^nnd if 

do t 

if ClIS^BADt “*toJ li //scimivity 
#ifdef USE^HASH 

IbestHove 11 

fendif 

gStartDepth - depth kFullDepthPlies || 
ntUlOpen <= kSolveThreshoid) I 
gInrScorc ” - (gTncScore * MakeMove(‘to* side)): 
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MacHack '97 J 

June 26 - 28, 1337" De#rbprri..Mi£hi0aii J 

'• The 1 2 th Annual Conference for Leattihcj DevelQpers j 

; 

Can for Papers: Write for MacHack *B7 and Get Pamoua > 

i ■ . - , . '►t'- ^ 

pt^ertaefe papers form a comerslorte^of ] 

1 \ premiere Macintftsli lechnicq 1^ 

1 yVv Papers obvera wide variety ' 

1 / 1 ot cool topics. Anything from Adaptive 1 

Cpfhpu ting, the business of Macintosh 1 
Development, Game Design, and 

4 liitemet programming, to Debugging, ' 

* >y the Programming Subculture, VR, and 

Mac OS internals and hacks. 

Would you like to astound and amaKC your peers and also get a free 
conference registration? If so, then share your in'depth knowledge of a 
technique, technology, philosophical point, or some other arcane 
knowledge and write a paper for Macflack '97! 

Point your favorite email program to mochodcixipeis^^TiK^ and 

send us your idea, abstract, questions, or other s4M:riets, Abstracts are 
Inquired by rebruary 15 . 1997 . 

Reg Fee; # 42 * .SpcahcfSi *325 before April 1 B, 1 997 

AlLenckimre 1 ^ llmltect - regtetcr early. 

Bound proceedings Best HacK CD will be riLstrfbuted to all attendees 

For more InforitidUoTi or to leg.lster: 

Dtpolecfi 1364 Bedfonl m. Gross* Fointe Farit, M] 48230 ^ 1 116'1513) 882-1834 
eapoted^iMccAcom—http: //www.nroc±MdLCEm/ 

|‘ladftti:^h Is [ft tracb^HiAk fiT r:inT>jiitti:t. All to ilielr niispectlw Iwlcterai. 

riatlliicK bt ft tratletnAfk tjf t^iirHjIcch. Ine Mot ollUldtcd iurfth tite ftoiHox OrtHJiKTMK 





’H'gPly; 

I ^ Search{ beta, alpha, nextSide, depth'I, 

false): 

-RPiyj 

UnioakeHoveO; 
glncScor** fsaveTnfScore; 
tflfdef USE HASH 

gHashVshir ^ saveliashValuet 

If end [ f 

if (gAborled) I 
#ifdef USEJIASII 

beatHove - NULL: 

iS^endlf 

break; 

I 

If (t: > beaiScure) I 
tfirdef USE,UASU 

bestMove “ 'to; 

Ifendlf 

if Ct > alpha) I 
If Ct >- beta) I 
bestSfore “ i: 
break: 

\ 

alpha “ t: 

* 

besiScore ^ t; 

J 

1 

1 while (Uo); 

ScorchedT : 

#i£ilel USE_UASH 

gltashValue *= kSwitcllSiiieHash; 
ffendif 

gTreeEnd “ firfltMovei 


lifdftf USR_HASH 
if (healMove) { 
ifcndlf 
lia^abSave; : 

^fifdef USE„HASH 

pHashTable = ^gHashTableCgHashValue & kHashTableMask]; 
if (pHashTflble->Deptb C** depth) ( 
pRashTabl e->HashValtie = glfaahValuet 
pHaahTable >Dcpth “ depth: 
pHashTabXe >Scorc - bestScore: 
pHashTable•>BestHove bestHove: 

KY^ASSERTirbestMove [| IS.EMPTY(*bestMove)): 

pHashTable'>Type = VAI.ID: 
if {bestScore oldAlpha) I 
pHasbTable >Typc " JPPEJt.B<lUND; 

1 else if (bestScore >= beta) ( 
pHasbTable >Type - iOWER„BOUND: 

] 

] 

] 

#endif 

return bestScore: 


Generate 

^define ADD_MOVE(pSq) •CgTreeEnd+t) - pSq 
long Generate(unsigned long side] 

PSQUARE 'e, p. q, •afterComers. *aovesSLatt, lastflad: 
unsigned long enemy: 
long i, *pOffsetsj 

enemy = OPPONENT(side): 
afterCorners = movesStart = gTreGEnd: 
lastBad - NULL: 

e =■ gEmp tyAdj: 
i = gSixeKtfiptyAd J: 
while (1 ) I 
p = ‘e; 

MY_ASSERT(lS_EMPTY('p) && (*p ^ ADJACENCy)); 
pOffsets ^ gOffestB: 
do I 

q “ p + *pOffsets; 
if C*q ^ eneiny) I 
do I // Skip tbnouidi hoc of enemy disks 
q * pOffsets: 

) while (*q ^ enemy): 

if C‘q & side) ( //Add sqnartf p to move list! 

// Ifcid? Tf>' lo pul It on the end 
if (IS_BA0(‘p)) I 
if EMastBad) I 
lastBad ^ p: 
break: 

1 

ADD_MOVECpl: 

break; 

I 

if niS_CORNERC-p)) ( 

// Add to end aittT corners 
AOD_MOVF.(p) ; 
break; 

1 

// Comer: keep all crirntTs tju from 
if CafterCorners -- gTreeEnd) f //All are c<»mersf 
ADD_r!OVE{p): 

1 else I 

unsigned long •tcniip *artcrCDrners: 

•afterCorners p; 

Anu_HOVE(tempJ: 

1 

++311erCorners; 
break; 

1 

1 

I while (*C++pOffscts)): 

^-^e: 

I 

if (InstBad) t 
ADUJIOVEdastEad); 

) 

ADD_HOVE(NOLL}: //sentinel 
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return (long){gTreeEnd - movesStart3 ■ 1: 


JViikcM(^vc 

// Makrs the mcive firw “ijidc'nn itic;''ta'‘squanr 
// Saws the move tu fur IhUt jodii'litj; 

// Returns ttu‘ diauge in store relative to the moving side 
SCORE MukeKove(FEQUARE to, nnnlgtied long side) 

1 

unsigned long zi 
PSQUARE q. 
long dir, offsetr 
long flips ” 0; 

SCORE neoro = 0; 

unsigK^jd long eneBiy = OPPONENT(nidc): 

H¥„ASSHRT(IS_EMPT¥{*to) A4 (’ ta Si ADJACMCY)) i 

#lfdet USE HASH 

// Update hash for new disk 
if (side -= BUCK) 

gHashValue ’(to + gBlackHn^shOffsot) j 

Rise 

gUashValue *(to t g¥hitoHashOffaet)i 

^fondif 

START^SAVE; 

// lli) Hipping, Update adjaeeiiL 7 
dir - 7: 
do I 

oTfset ^ gOftsets [dirl: 
q = to + offset: 
if (IS_OK_BOARD(*q)) I 
if (IS EMFTY(*q)) t 

if C i(*q 4 ADJACENCY) ) I //Rtst adjaecni 
ADD_TO_EKmAJ>JCq): 

seoro- i // New disk Kniehes efnpty which is bad 
I else if C*q & enemy) I 
// Skip througli line id enemy ffisk.s 
p q offset: 
while [*p h ont^my) 
p offset: 

if (*p h side) I //Hip cm 


// flip disk at p 
^^Ups; 

if ClS_ET>GK(*p)3 
snore kEdge: 

PlTSH_S{}{p): 

score - (COUNT_EMPTIES(*p) « 1); 

// K2 liinptics counted for us m^w 
*p C0L0R_BITE: //Flip 
SUAbT USKJIASH 

gHashValue '*= *(f + gFiipHashOffset)! 

// Update hash Rn' flipped disk 

#(^ndlt 

p += offset: 

J while (*p & enemy); 

SCOre-f-+- 

// I'iils Lit area annind disk at (| which is now ouis 

\ else I 

score-: 

// Fills in area annmd disk at enemy disk at q 
I else I //*q&SHk 

// Fi!ls in area around our disk at q 

1 

z - 0HF„DiR_BlT{dlr3: 

MY^ASSERTECq & e) ^ C1L); 

I •<! 1= a: 

I while (dir-); 

PUSH SQ(to): 

REHOVE FR0M_KHPT¥At>J{to): 

'to 1^ side: 

PUSH(gCounts LWHITE.INDEX]): 

PUSiKgCounts[BLACK INDEX]); 


gCotintnIside » COLOR^SKIFTl I- flips ^ 1: 
gCounla[enemy >> COLOR.SHIFTt -* flips: 

if (lS_EDCEC'to)) 
score += kEdge; 

return score; 

I 

I inmakeMove 

void UnmakeHoveO 
I 

FStjUARE to. flipped, q: 
unsigned long z; 
long dir: 

// Kesion* disk counts 
gCounlaiBLACX^lNDEXl POP; 
gCuiints [WI1ITE_INDEXI = POP: 

// Replace lo-dbk 
to - (PSaUARSjPOP: 

*to “ POP: 

ADD TO EHPTYADJdoJr 

//1 fndo disk chants 
while (POP) I 

flipped “ (PSQUARE)TOP: 

•flipped « POP: 

1 

// Update adjacenev 
dir » 7: 
do I 

q ' to + gOffsets[dir]: 

■& - OFP_DIB_flIT(dir); 

' q k- : // Renittve adjac enn^ (if not alieady fiemuvt*d fmm disk changes) 
if ( IS.EMPTYC'q) A A Ifq A ADJACENCY) ) I //First adiaecm 
REHOVE FROM EMFTYADJiq): 

I 

1 while (dir-): 

1 


Initiali/je 

void lnltlalize(long hoerdRIze, void *privStorage) 

unsigned long •p, 'q; 

long i, index, numkealJ)quareS: 

char •prr: 

linn I good long z: 

IlFdof USEJiASn 

unsigned long rl, r2: 

#endlf 

kX = -2 - hoardSlae * 5: 

kC = -2 - bocirdSize ' 4; 

kEdge = T + boardSlae / 0; 
kCorner 1 + board Size • 13; 

gflenl IVoardSize = boatdSize I 2: 
gNumOnSquares - boardsize ' boardSize: 
numRealSquaree = gRealBoardSize • gHealBoardSlze; 

ptr = privStnrago; 

gSquarfin (un-^igned long Mptr: 
gOnBonrdSLnrt - gSqusres + gRealBoarrfSIsie + 1: 
gOnBourdEnd ^ gSquares i (gRealBonrdSlze * 

(gRonlBoardSize ’ 1) ‘ 2); 
ptr i= numRealSquares * 4: 

// worst ose 66^66M = 17,424 h>tt*s (-t7K) 

#ifdef USE HASH 

gWhiteHanhOffsoL ^ nuttjRealSquares; 
gBlflckHashOrfsei = numRealSquared * 2; 
gFt tpHashOf fjset = nuaiRaalSqUarea * 3; 
pLr += (numRealSquares '3) * 4: 

// worst case 66^66^3^4 = 52,272 hytrs (-5 IK) 

gHashTable = (SRanh *)pir: 

ptr +- kHashTableSizc * sizeof(SHash): 

// 5276ft* 16 = 524,2ftft bytes (512K) 
ffend1f 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP ™ and 
Open Transport™, here's your solution! 

♦ Supports ScriptEdilor, FaceSpan and I lyperCard™ 

♦ Build net-wise WebSTAR CGI scripts 
and NetScape™ CCI scripts 

¥ Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 

♦ Featured on the Apple® Internet Server 

Order now through the MacTcch Mail Order Store at 
805-494^9797 or other mail order stores 


w 


Mango Tree Software, Inc. 

Box 1057 * Brookline, Massachusetts 02146 
617-327-8663 

bUp ://www. ma ngotree. com/bi^/nia ngo 


All iire propertied of iherr respetlivi.' holders. 

Contact Mjrygo Tree Software for site licensing and redfsiribiilion infoimtlirjn. 
Copyright © 1^196 Mango tre-e Software, Inc. 



FTP Parameters 


1 


Set these paran 
Csending) files i 


FTP Host 
Directory 


Telnet Libre 




User ID 
Password 


Type of file tra 

O MacBinary File 


^ Description : 


Telnet Library v1.0 

Copyright © 1995 Mango Tree 
All Rights Reserved 



Record Run - 


set my_tel net-stream to telm 
tell my_telnet^tream 

try 

connect(your„ho 3 t) 
read until-textf'loc 


gEnptyAdj • {PSOUARE Mplr; 
ptr += gKiimOnSquares * 4: 

// worsi cast’ - 16 .,^f bytes (1 f>R) 


p += CgRealBnardSize - 1): 
Mp++3 = BOKDER_BTT; 

I while f-ij: 


gChenges (unslgni^d long ')ptr: 

ptr += 65536r //c,g.64 moves (deep)* 256 kmgs/MKwe ' i hytrs/loftK 
//65.556 byiesC64IC) 

gHoMlity (long *3ptri 

ptr += 1024 : //e.g. 256 mmes deep * 4 Ifties/limg 

//t,024bm*sUK> 

gCountJeros ” [unsigned long ")ptr: 
ptr 256 ‘ 4: 

// 256 * 4 = 1,011 b>tes(lK> 

gTree - {PSQUABE ‘)ptr; 

// CfLs wJeifs kfi. almosi 4flt)K! 


// ** Calculnte dirt'CTional oflscis 
gOtfsetsfOIR^S] ' gEealBoardSi 2 e: 
gOlfseta tDlR_R] - gRealBoardSize j 
g0ffsets[DlR.SE] = gileal BoardSize + 1; 
gOffsets lt)lR_KWj = gReelBoardSize - 1; 
gOffsetsfOIR^NEj = - gRealBoardSize i 1 ; 
gOffsets[DIR SW] - gRealBoardSize 1; 

// Bortlcrs 
// Uppcf/liJwcr 
p ^ gSquaresi 

q “* gSquates + (gHealBoardSlze * (gRealBoardSlze 1)): 
1 = gRealBoardSize: 
tin t 

‘(p++) - BOHDER_BIT: 

*{q^) ^ BORDER_BIT; 

] while (-i): 

// Sides 

p = gSqear^s + gReal&oardSizfi; 
i = gRealBoardSlze 2; 
do ( 

*p = BORDER JIT: 


// Idges 
// tlpper/lriwer 
p * gatiBoardSTflrt: 
q “ gOnBoardEnd; 
i - boardSize: 
do I 

*[pM) “ NWJORDEH t N_BnRD£R | NEJORDER; 
‘(q-) = SW^BOROER | SJORDRR | SE BORDER: 

I wh! 1 e (-1JI 

// Sides 

P * gOriBoardSrart; 
q gOnBoardEnd i: 
i - boardSizu: 
do I 

*p h [iWjORDER I WJORDKR I SW BORDER: 

*q 1^ ME BORDER EJOKDSR \ SE, BORDER: 
p +“ gR^alBoacdSize: 
q - gRealBoardSize: 

\ while t t): 


Surting cnnllgmaTinn 

// Set up initial disks am! adjacent empty- squoits 

yuur firsi move, you should initialize the bijard 
// with white tiles at (mw.col) = (board-Sizc/l-l luKirdSizc/l-l) and 
// (h(KirtlSi7e/2.boaiidSiae/l).and black tiles at (boardSize/2 CboardSizc/2) 
// and <boandSi7c/2,h<jardSize/l l)’ 

gCountt^lmTR^raOEXl = gCounts iBLACieiHDEXi - 1; 

iSizeEtBptyAdj " 12: 

1 = boardSize >> 1; // 3 t 2 
IndRX “ XY2INDEXtlK 11): 


p &£Squares f index]: 

"p = SE: gEmptyAdj to] “ p: 
‘(-k-Hp) = RWPTYADJ fllT(l) 
“C++p) ^ KMPTYADJJITCZ) 
•(++p) ^ EMPTYADOITG) 


S 1 SE: gEuptyAdjfll - p: 
S¥ I S; gKii:piyAdjl2l - p: 
SW; gEmptyAdj[3l - p: 


62 


Programmer’s Chauenge 


MAdTcOLMAGA/tM! • MaY 199? 

































p += gRealBoardSif-e 3; 

- EMPTTADJ BTT(4} | E | SE; gEjnptyAdj [4] - p: 


»(++p3 - WHITE 
'(-H-p) ^ RUCK 


SE 

SW 


= RMFmDJ_BlT(5) 


S: 


SMi gEmptyAdjLsJ p: 


p += gHealB^^ardSlze - 3i 

■(1 = EH£TfADJ_BIT(6) | R ] NEi gEmptyAd j (61 - p; 

•(++p) = BLACK I N I HE i £; 

•{++p) “ WHITE I W I NW I N; 

•(++p) = EMPTYA[)J_B1T(7] [ W | NW! EEmptyAdJ [/] ” p; 

p E" gficalliDardSize ■ 3; 

•p ^ EMmADJ_BI 7 (a} I HE; gRinplyAdi(8| “ p; 

•(++p) “ EMPTYADJ_BITi9> | N | NE; gEiuptyAdj f9] = p; 

‘(++p> = EHPTVADJ BTT(IO) I NW I N; gEaptyAdj[10] - pt 

"<++p) = EMPT¥AD.I_BTT(11) NH; gEnptyAdjfll] ” p: 


Guess which 
installer 
was built by 
DragInstalL 


gtraCornBr ■ gOnBoardStart: 

gNHCl gNWCorner + 1: "gHWCl [- BAD.BlTi 

gNWCZ - gNWCorner + gRealBoardSlxo: ■gNWC2 |- BAD_BITi 

gtmx ^ gNWCa + 1; ‘gNWX |- BAnjilT; 

gNECorner “ gNWCorner + boardSize - 1; 

gNECl * gNECorner - 1: ’gNECl |- BADJIT; 

gNECZ - gNECorner + gKealBoardSiza: ‘gHEC? I- BAD_fllTi 

gNEX “ gNECJ 1 : ‘gNEX j= BAD, BIT; 

gSWCorner = ^OtiBoardEnd - boardSlze + 1 ; 

gSWCl " gSWComar + 1; ’gSWCI |- UAD.BIT; 

gSHC2 = gSWCornec - gRealBoardSize; •gSWC2 |- BAD_BTTi 

gSWX = gSHC2 + 1: ’gSWX 1= BAD_DIT: 

gSECorner ^ gOnBoardEndr 

gSECl - gSECorner - 1; 'gSECl j- BAD.BTT: 

gS£C2 “ gaSECooier - gRealBoardSiie: *gS£C2 BM_BIT: 

gSEX -- gSEC2 - 1: -gSEX \= BA1>_BIT: 

// Prcciinilatc gC:ountZcrcw 

// (Could have had die compiler fill these in. but Fm not 
// “niAT desperate lor speed) 
for z<2^6; ++z) I 

gCountZeroetzI = 

B - iz h i) - {U»0 i 1) h 1) - i{t>n} 4 

1) - 

((z»4) & 1) - {U»5) 4 1 ) {(z» 6 ) 4 1) - (U»7) 4 

tJi 

1 

tfifdef USE^HASH 

ftHashValue ' OxFFFFFFFF: 

// IniciaK/e gHashKc>s 
& ra nd [ Ox 12 3 4): //sniDd(Unie(Nl 11 J.)); 
for (i“ 0 : i<nuiiiReaXSquaresr ++1) I 

rl = randC) + ((imslgned long]rand() << 16) j 
r 2 = randO *■ ((unsigned long) rand 0 C< 16) j 
gSquarea[gWhiteHashOffset + i] - rl: 
gSquarefi[gRlackUaflhOffset + i] ^ r2 r 
gSquares [gFlipHashOffset + i ] = rl c2: 

) 

// Clear gtiashTabk 

i 

Sliash 'pHashTable ^ gllashTable: 

i - kHaabTflbleSize * 1: 
do I 

pHaGhTable->HaflhValue = 0: 
pHashTable->Depth = -100; 
pHashTable->BestHove = NULL; 
pHaahTable->Typs = INVALID; 
pHashTable->Scor^ • 0; 

-H-pHaetiTable; 

1 vMle ( 1 -); 

I 

#endif 


gineScore = 


0 ; 


-—- ■■ — installer 



^ Eih’ fiid 


1> 



^ a 




DOnAiiiitBillDn ICTWlWWIlKBfflHl 




^ ” Si 

Icons 


O 

Vartiipooo 


Tytw-W F>lo* j 






a 







o 




Tht of Uvt wWoto ihe'rfj iddtiilowt Insliinilfavd. To itr t, 

ftlool On* Or irwr* of ihm Wf ond dvog to dUt on th* rlgM ti 
of tlie window. 


f Read Me ] 

! Ouii I 



Guess again. 

If you guessed that the first installer was 
built by Draginstall, you’re only half right. 
Now with Draginstall 3.0, you can build both 
of these installers from a single script file! 

For more information about Draginstall 
and a free demo, visit our web site at 

http://www.sauers.com/dragfnstall 
or give us a call at 1 - 800 - 890 - 9880 . 
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FROM THE 

FACTORY 

FLOOR 


by Dave Mark. ©1997 by Metrowerks, Inc., all rights resertjed. 
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Greg Galanos and the Mac Developer’s Roadmap 


■[■his monili is, |K*rhaps, one of the 
most ini[)ortanl in Applets history. 
AlLliougii Apple has shown st^me spark in 
recent months with the release of some top 
notch prtxlucLs, the key to their success 
clearly lies in the timely release of 
Rhapsody and Rhapsody related tools. 
With tliat in mind, this month's interview Ls 
with Greg Galanos, Metrowerks' founder, 
President, and Chief 'I’erhnology OfTicer. 
Greg presents his views of Macintosh 
development a la C(xJeWarrior as we make 
our way into Rhapstxly. 

Dave: Ijet's start off witli an overview. 
What changes do you see coming 
down tlie pike for (xkIcW arrior? Will 
the versions of CxKleWarrior retain a 
unified l(K>k on dilTereiit hosts? 

Greg: No maner where you program, 

you will have essentially the same set of 
tools to do your work. 'Ihe host 
plalfomis that we an^ ('oinmitting to and 
their order erf inifxjnancc (for our Mac 
users) arc: MacOS, Rhapsexly, 
Wine.k>ws95, WintlowsN'l , lieOS, Solaris, 
SGI and 1 IP. We are siriving to create one 
powerful, integrated development 
plaironii regardle:vs of the host. 

We're targeting the creation and 
deployment of a amiplete development 
platform dial includes pix)ject 
management, pro|e<l builds, editing, view 
editing, reMvurce editing and codegen. 

Tile new project manager Ls ready for 
prime-time and incortx;rates many new 
fetitures including sul>projects, miiUi- 
tiirget l>uilds, a new build system, new 


searciiing algorithms and the new CodeWarriejr look and feel. 

The CodeWaiTior VC5 pIng-in for plugging alternative .source^ 
ccKle cT>ntrol systems is now ix'ing supjx>iied by CodeManager 
from Metrowerks, Vcxjdoo from LIni Software Plus, and various 
shareware and freewiire versions of Pix>jccU)r. 

We intend to move ahead with a tools driver architecture that 
will make support of multiple t(K>ls plug-ins to l>e lietter 
maintainable from our own inicmal engineering perspet:iive. 

We will be deploying a new generation of the CtxleWarriDr i 
pltigdn API that allows us to take into act:i>unt endian issues 
Ix.awccn different host platforms (necessary to accDunt for 
little-endian NT and little-endian Rhapsody), and simplifies the 
task (rf porting c:omrnand-line Uk)I.s to lx? CodeWarrifir plug-ias. 

As far as RAD is concerned, the objc'clive for the RAD part of 
CfxJeWarrior will lx? lo stipfiort PowerPlant for C++ on 
MacOS, MFC for C++ on Windows, the Ol^KNSTEP and 
Rluifisody APIs with Ohjective-C on Rhapstjdy, and the 
a>nglomerate of APIs for Java iAWT, IFCJavaBeans, AFC) on 
all platforms. We will implement fine-grained code- 
generation to support these technologies. 

(Jn Debugging, the debugger will lx- integrated into Gxle^imior 
and inajrfxmiic a plug-in architetturc that allows multi-taigei and 
twiMiiachine dei^ugging from within QxleWarriot 

'Ihe upside lo all this is that all the components of CodeWanior 
will lx* integrated — you will lx able lo manage ycxir work flow 
much more efficiently, and uansitions ixiween OxleWarrior 
components will lx* much smoother fnim ctxJing, tt> builds, to 
debugging, lo f>mwsing, to user inierfate design and back. 

Dave: What's the time frame for these changes? 

Greg: Our plan is to deploy these technologies within 

CodeWuTior over rht‘ next 5 to 6 releases of the CodeWarrior 
SDK, starting with the just released CW12. 
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Behind every good Mac app... 


Every job requires the proper tool. When It 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


“If you have to spend time with text 
on the Mac, you should use BBedit.” 

- MocWeek, September 30,1996 


• Comixire source files and 

apply differences 

• Open From and Save To FTP 

• Search and replace multiple files 
using Grep 

• Navigote source files with integrated 
PopupFuncs’** technology 

• Browse project documents 




Blingie Software's Marathon Infinity, created using BBCdit. 





Source code from Marathon Infinity disployect in BBEdit 


...is a great 
text editor. 


BBEdit 4.0 




http://www.barebones.com/chainsaw 

To order, coll 617-778-3100 



Bare Bones Software, Inc. 

KO. Box 1048, DedfonJ. MA OlTSd • main 617-778'3K)0 * fax 617-778-3111 


BBCdit Is »tradenurkof Ddie floncs SoftwarL^ Inc, Alt iHtwr iradufrnorks ond n'l^U^tvnMi tfadijmarks are pniperHcsJ of tticir rtSpcctlvt' holdpni,4? 1^7 (Jan^ Sofiwait*. Iru. 





















Dave: You often ^peak about the ""road to Hiiapsody” and 
your desire to provide a road map for developers. Can 
you clarify that a bit? 

Greg; 'iTie rojici to Rfiaf)M>dy is more like a six-lane liighway. 
Tliis liigliway has lo carry the CcKleWarrior Platlbrni and 
Tools as well as the entire Mac community from wlicrc‘ wc 
are now across to RhapMxiy. DilTcrent technologies need to 
be implemented in each lane and not all technologies move 
at the same speed. I see the lanes as: 

1. Code Warrior compilers and linkers. 

2. Current NeXT compilers and linkers. 

3- Code Warrior Debugger technology. 

4. Cx;KleWarrior Knvironment. 

3. CcxleWarrior Lilitudc. 

6. Metrewerks PowerPlant. 

Dave; How do you see the evolution of the CodeWarrior 
compilers and linkers? 

Greg: line CxKleWarrior c:oinpilers anti linkers will l>e modified 

lo allow tHir customers to use their language of choice, and to 
use the current system-prelerrcd language. OlijecTlve-C. 

In ortler to do iliis, we’re essentially taking a path analogous 
U> the patli chosen for SOM. When we implemented support 
for direct to SOM in the CodeWarrkir C++ compiler, you 
would esseniially derive from a SOM object in your standard 
C++ source code and tlie compiler front-end would take care 
of generating the correct runtime bindings sc) that the SOM 
object could converse with the sysieiii-levcl SOM runtime. 
'ITiis was called direct lo SOM or cIlS and it allowed us to 
bypass using SOM 11>L (Interface Definition Linguage). 

Well bt‘ taking the same approach to implement Objective-C 
runtime supfxm. This means you will derive from an 
Objeclive-C object in your C++ or Object Pascal prograin and 
the compilers will genentte the projx-r runtime bindings for 
the Ohjective-C runtime. 

In the above case, Apple wall need to pn)vide the C++ and 
Pasc:al headers for Rhapsody that contain tlte entry point in 
the Ol>jective-C .system runtime for this to work, but ai this 
time it is tmr understanding that eithcT Apple or Metrt>werks 
will finti a way to make this Jjapixm, 

The conclusion here; use your current language of choice and 
bind to the Rhap.srxly system APIs. 

We also want to provide people with the possibility of 
adding Objective-C syntax to either their C or ihetr C++ 
code. This will be done through the use of a front-end 
language extension switch that will tell the compiler to 
accept the proper Ohjective-C syntax constnua and 
generate the proper code for it. 

(jHI'G Gaiwnos and rii+: Mi\c DrvKicx^HiPs Roadmap 


So. that is whar we Ye doing from the compiler sLandj)oint. It's 
interesting io jx>int out that this work will lx used by both 
the PowerPC ;ind Intel back-ends which will allow us to also 
implement support for Rhapsody nmning on Intel as tliis 
seems to lx a direction tliai Apple will continue to support. 

Changing the compilers is great and fills tip half the lane but 
we neeri to go fimher and generate the system executable 
formal. On Rliapstjdy, the undeq>inn!ng is the Mach operating 
system version 2.5 C)r higher, so we need to implement 
support for native linking of this formal. In order U3 do tills, 
we need lo support Maetn), ihc native executable format on 
Rhapsody. This is well defined on Intel where the Mach kernel 
is already operation^il (under OPKNSYT.P). By tlie Lime you 
rend this, it will also have txen well dcTmed on PowerPC as 
we work closely with Apple to make this liappen. 

Oh, 1 forgot to mention the .symbolic delmgging format... It 
l(X)ks like w'c are going to standardize on DWARF (Debug 
With Arbitrary Records Format). DWARF Ls an industry 
accepted standard debugging fonnai used extensively on 
SVR4, RSD43 and embedded ofieraling systems. It is a 
pn>cessar and plailuaii indejxmclent data format, rich enough 
to define all symbolic necessary for full source-level 
debugging. It is also language independent. 

Now, Icfs ajmpliciiie matters .some. What about OFFNSTEP 
running on N'l? W<H1, it uses the standard MienMjft COFF fomiat 
executable, and this is essentially flxetl up at runtime by the 
OPFNSTCP ObjectivcM:! nintimc loader so that the exeaital:>le 
am am and connect into the CJ)PFNS'rFP runtime. Don'i ask me 
how they do it, thfjse NeXT guys madt* magic. However, given 
that our Windows95/NT compileivlinkers .support Mioosoft 
COFl', tlien tlie NeXF magic should work with our NT compilers 
loo, which nxms that with the QkIcW arrior ifxilset, you should 
be able to build hinaric'S nca only for Rhapstxly on PowerPC and 
Intel ninning on top of the Mach kernel, but also for C4PFNSTFP 
running on top of NT. Fm not even going to start talking about 
(^PFNSITP on Solaris Ixauise it's starting lo make my head spin 
like Meryl Sircxrp's in Dmih Ikxomc^ fkr. 

Dave: How do the current NeXT compilers and linkers 
ni into all this? 

Greg: OPKNSTHP’s cuntmt icx)ls arehilecture leverages tlie 

important w{3rk done by die Free >Soriw'are FtJundation in their 
support of the GNU cxjmpiler and linker t(K>l set. 'Hie GNU 
compilers and linkers are wc*ll known for the cjualily of iJieir 
generated axle albeit in llie fonn of coiiipilers and linkers that 
are definitely niK on par with CcxleWarrior amipilers from a 
strict time to market’ (read higli .speed) standpoint. Nevertheless, 
these compilers, which form the l>asus of the Ol>jectiveG 
<'ompiler tedinokjgy used on OPENSTE'T, are used today by 
iTiost R not all OPCNSITI^ devekrpens. lliey l>uild the code that 
mns on tlie plattbmi today. We at Metrowerks nin into tfie GNU 
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compiler arcliitecturc all over the place. For example, whenever 
first silicon for a new \)n)cossor is Urought up, .someone usually 
reiaigcls a GNIJ coinf^ilcr to supf:)Oit tlic cliip. Tliis allows early 
users to quickly apprtxich the new silicon. 

Because they are l>eing used lor the curreni incarmitioii of 
Rhapstxly and also for silicon bring up, it is in Metrowerks’ l^st 
interests to make sure tliat thei;e c'ompilers and linkers can work 
properly within the (kxlcWarrior Flali'orm. For llicse reasons, 
we've decided to fund tile devekipment of GNU compiler and 
linker pKigdns to the QxleWarrior IDE. (!)nce the plug-ins are 
developed, the plug-in axle, based on the CcxJeWarrior Plugdn 
T<k>Is API, will he given t>ack to tlie Fiec Softwam Foundation 
so that anyone using the GNU technokjgy can build a GNU 
compiler or linker ^is a Code’^t^irrior plug-in. 

This meets tiiree objectives- First, it allows cunent CodeWarrior 
cu,sromers to use tlie airrent Rhapsody cojnpilers and llhapscxiy^ 
tinker to suppon .seed versions of Rhapstxly or eurrL‘nt versions 
of OPENSTEP from witliiii tlie CodeWarrior environment; 

Second, as we move the CodeWarrior Platform to Rhaps(>dy, 
it will allow OPENSTEl* developers to use the CodeWarrior 
Development Environment as the back-end build system to 
Interface Builder as an optional build system to NeXT's {er, 1 
mean Apple's) Project Builder on OPENSTEl^ Tltis allows the 
merging of two state of the art technologies — CodeWarrior 
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for builds, Interface Builder for RAr> — to interopenite 
seamlessly (or tliat's the plan). 

Finally, it allows us to transition GNU technology users to 
CtxleWarrior in the emIxxJded systems markci ;ts chip volume 
for new silicon increases and customers start looking for high- 
volume, low-ccist, off-tlie-shelf development tools in order to 
support a new or existing ISV developer base on a new devit e. 

By the time you read this we may liave figured out what weTe 
going 10 do reg^irding debugging for GNU, but our game plan 
rigliL nc)w is to figure out how to use our own source-level 
debugging technology with the GNU compiler technology. 

Finally, with respect lo cairrent OPENSTEP L(k>]Sj one thing 
missing is to build the QPENSTEP/Rhap.sody linker as a 
CodeWarrior plug-in. W'eVe working closely with Apple to 
achieve this goal. By the time you read this, I as.sume w^ell 
also [lavc figured out how lo get the Apt^le teclint>logy such 
as the Linker to you efficiently. 

Dave: Wbat arc your plans for Java? 

Greg: Java clearly is here to stay and Metrowerk.s is investing 
aggressively in the areas of Java technology that retjuire 
world-clas.s ttx>ls: JITs, java eompiier, RAD, and VMs. 
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Mctiowerks JIT teciinc>k>;jy is based on a lutLU’^ctable aiiiifiilcr 
technology dint allows us to retai^^ut tlie jIT for diffea^nt 
firoccssors. Currently, Metrowerks has JlTs available lor 
PowerPC and 68K MaeOS. Hie fact that lliese jlTs are 
developed and tested on mklinux al.so means that they are quite 
f)!alform independent and ran lx- used holh for Rhapsexly and 
for embedded 68K and PowerPC] targcLs wilh .some 
mcxlifications. Our first objective with resjxxt to ^HTs was to 
t:reate a roliust ini pie men tat ion and we have tione so. 

Oin h)llow“Up objective is to provide Ix^tter optiiiii/iitions as we 
are doing this. Hvery^ iteniiion of a CcxleWarrior ITY iias seen 
increased perfomiance. We are weighing oprimiziitions versus 
real-time jierfonnancv as optimizations are dearly a two-edged 
sword when you're JITing etxle. Hie opiiniiZiititins you pin 
into [he irf, die slower it Il ls the applet. It's very iinpoitant to 
Ixilancc ofXimiZiiiions with rtmiime |X'rfonTianc:e and we’re 
making sure we don t optimize ixir jfr to tlie jx>int whem it takes 
longer to rmaslare the axle than it dtx^s to tnteq>jei die etxle. 

Additionally, we are building JITs ft)r einbedded targets. One 
of the first is for NPC Flearonics V-HOO series processor, a 
RISC processor with approximately 20 times the performimce 
of the 68k serie.s fh>ni Motorola, but at around tlie same price 
point, rhe V8CX) prexessor is the building block for NEC’s 
sy.stems-levei offering for digital television (satellite receivers, 
Internet-ready television, digiial audio/vitieo sub-systems). 

Gm'r Gaianos and ihk Mai; Diwihopfu's KoAnMAF 


WeVe also working t:losely with Sun Microsy.steois, Apple and 
Micixxsofi to imiilemenl and supfXJrt tlie [IT APIs fnxii diese 
companies, so that Ills am Ix: interoperated with different VMs. 

Dave; How about a native Java compiler? 

Greg: Java is a real interesting l^east in that even though it is 
platibnii and pnxessor neiiiral, different technologies need to 
lie implemented in order for it to be effident in Ixjth execution 
and memory fcxitprint. It challenges tlie developer of tools in 
that a wide varieiy of opiion.s are necess^l^y ciepentiing on the 
mntime characteristics of the target. For instance, if tlie tai^et 
is a desktop machine wilh loads of RAM, either JIT or native 
binary compilation is an option. However, both of the abewe 
sokititMis incrc^asc memory usage dramalically (an f>rder of 
magnitude) for the final executable, compared to just 
interpreting the code witii the VM interpreter. 

We're making sure our customers have all the options 
available in CodeW^irhor One of the things well be doing this 
year is developing onr owm fully integnited Java compiler 
This compiler, comprised of a fronuend and a back-end, will 
Ix" fully merged into the CodeWarrior compiler technology 
base. Tlie fmnt-end will generate code to the (^deW^irrior IK 
(interinecfiaie memory resident representation). The Java 
hack-end will generaie die hytccxxlcs. The advantiige of 
generating for the IR is two-fold. First, it allows us to leverage 
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I he opiitni/CDi ij,sed by eunx^it coiiipilers (C/C++ and Pascal) 
on the IR, 111 is in turn allo%vs the Java back-end to ^enenite a 
Ix.^lter' hytc-code sequence. Look at this as generating (letter 
Java I’lyte-t'CKles, whether they are JITcd or run on lIk* VM, 
tlieir optimized generation will make them run more 
efficiently (at least that's the {>hiective). 

Of course, Ute fact tliat die eoiut>iler will lie written in ANSI 
C, as all of the CudeWaiTior compilers are hxlay, wall also 
give customers a screaming implementalifin of the Java 
compiler as last if not faster, given that it’s a simpler 
language, than our C/C++ compiler. 

Sectindly, given tliai we are generating the CtxleWarrior IR, 
we w'ill also Ix' able to use Metrowerks back-end technology 
for specific prtK’essors (PowerPC,68K,x86,MIPS,V8tM}) to 
genentte a pure native binary, oner that will not retjuire 
JITing and will nin on llie target processor The caveat here 
LS diat we still need to figure out how to provide system 
services provided by the VM (such as gartiage collection, 
etcj to the native binary. We're working out die details of 
diis widi Apple and Microsiifi rt>r the two desktop platforms 
we supptirt. VoT the time lx?ing, well lx* calling the VM for 
the service where nec:essary, until a standard 'WM-naEive 
services’’ library is implemented by Apple and Microsolt. 

We re also cominuing lo invest in the Sun Java aimpiler as ihe 
currendy shipping compiler for Code Warrior CuiTenlly, the 
compiler has already l^een J2Ced. 'HiLs es,sential[y takes the 
current compiler, traaslates it to a C re p re.se n tar ion, then die 
QxleWarrior C t:ompiler irompiles it. It gives us a '’native” 
compiler dial gcfienites byte-code, but that is still a cousin of 
the original Sun compiler- Of course, weVe also gone ro great 
lengths to architea the Sun compiler s<) that it Icxiks and acLs 
like a nonnal Code Warrior plug-in. Well Ire implementing an 
IR-generating pass in the Sun compiler that will allow ils to 
generate die Code Warrior fl' directly, in order to sian solving 
the nindme issues dial arise fnaii native code generation while 
wc build die 111!) CtxkWanior Java compiler. 

So, in conclusion on Java trimpiler technology (jn" and Static 
compilation), we are iinfilemeniing dynamic compilation (jnj, 
Ixtter more optimized compilation (Java compiliM), static 
compibtion (Java front-eml to pr(x:essor-Larget back-ends) and 
enfianc:ed siaLic compitadon (other language fiont-ends to 
Picojavu prtx'ccssor target). Interesting, important stuff — lire 
baseline for our tools infrasmimire for Java, critical in die years 
to aime as Java moves fnnn early adoption to widespread u.se. 

Dave; What about Java VM support? 

Grq>; We got into die VM business e;iriy in iyy5 wJien it was 
clear that we needed a VM, and w^e needetl it for fxtr castonxrrs 
earlier tlian Apple was going to provitie a VM. Tlie Metrowerks 
VM, a derivaiive of die Sun VM, develojiecl under license, is used 
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t(xlay in Internet Explorer on MinOS and w^e've ju-st relaxed our 
licensing rt'Slritlions in our QxieWanior .s<>flwure license sii that 
any of our cusUnners can ship tlie VM bundled widi dietr Java 
applications. We developed two cipiimizcd byte-code 
interpreters, one for V\K. the other for (i8K. llx^ interpptters 
essentially accelerate alxiiit 150 hytexodes, anti tmaslate into a 
VM that Ls alx>ut Wh fasier than a stantlard VM without jlTs. 
We’ve just licensed this tedinology to Apfile Computer for 
in corpora cion into Apple’s VM. We'll also fx* shipping Apple’s 
VM as an option to die Metiowt'iks VM as fiart of any 
CcxleWanior Java tcxilkit (Gold, Academic, Discover Java). 

As .sex in as Af>t)lc and Micnjsdt agrt'c on supjx>rt for COM in 
Apple VMs, we will nxjve lo tninsition our cusiomejN to one VM 
on MacOS, provided m all ciLsiomt^rs by Apple as a Iraseline 
sysiem sc^rvice. Clearly, tmr goal is to exit die VM Ixisiness as diis 
LS rtrally a systcnii vendor areii wJiere we tlo not pn>vide clear, 
added value long-temi. On WindoW’S^>5 ancl WintlowsN'r, w^e will 
esstmtially ship ihe .Microsofi VM and xH6 JIT liu Jtssuuiing dull 
there will lx‘ a standaidization efToit on MiicOS and RluipscKly 
that will alltw us to do the same thing on Apple platfomis. 

We'11 ix happy Lo wt>rk with A])ple on providing the JIT 
technology as we have provided the OBCI technology and 
are working tow^ards this goal vvirli Appkr anil Mk:rosofL 

Dave: And Java RAD? 

Greg: Clearly, our first efforts lo sii[)|iorl Java from widiin 

Con,stnictt>r have been qiiite successful kii we Ixdieve we 
definitely need to go much further in the supptirt of visual 
tlevelopment in Java. As such, as pan our RAD 
implcanentation in CtxleWaniur, we will lx implementing 
complete suppon for Java visual development fixnn w'idiin 
CcxleWarrior, sup|xift for the devtJopmeni of the user interlace 
in a visual fashion, with fmc-grained ctxle-generalion, object 
wiring, and instant run' to provide immediate feedback to the 
developer of a Java application. Coupling ihi.s with a world- 
class devek>pment envin)nnienl and build system diat supjxnts 
mullijile languages will pnivicle a wc>rkl<lass, very^ powerful 
solution regardless of platform. Ihe It AD for Java support 
features will lie rolled out in CcxleWarrior in a .stepwise fashion 
as part of each QxJcWarrior SDK release as other technologies 
for C/C++ and Pascal fuive ken Rilled out over the last 12 
relea.s<.*s. (12 reletises in 4 years, 1 mirst lx* gelling old) 

Dave: What’s the story with Code Warrior’s debugging 
technology? 

Greg: As I said, wc are working on a merger of the IDE and the 

iiosl debugger techix^logy tt> make the development 
experienc-e confiniioas, 11 k‘ tiirmnt CodeWarritx debugger w'ill 
lx integrated into tlie development environment, so you w'ill k 
able to edit, compile, and debug all within the sjtme 
environment. This means all the fumiionality of the IDE will lx 
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avaLluble when you are debugging, and vice vers;L For 
exaiuf)lc, yt>u will lx: able to set hreakpoints in your code while 
you are ediiing. and ycxi will lx: al)le to dick on a symlx>l in 
the soiia'e you are debugging and make u.se of ilie [X>[>up that 
appc-ars (jump to a symtxjrs ilehnirion, for example). 

We are also adding support for two machine debugging in 
CxxleWarrior 12. *11ie CW 12 Mein^Nub now supports both 
single niaehine debugging and two niat:hine debugging via 
'fCiVlF, Now, you can debug your Mac aj)j>!ications widi the 
debugger njnning on the same machine, on a second Mae, or 
from ytjur Windows irox. You can also use the s^rme debugger 
to debug f>8K, PowerPC, xB6 and Java, all simultaneously. 

Supixrning Rhapsrxiy debugging i.s an interesting Ixrast 
because essentially wcYe talking aboui a mulri-Uisking, 
preemptive, memory-protected kernel and (you guessctl it!) a 
new ninge of services to supixjn on that kernel. 

'Irivia-slart — we did do some of this work for Copland (you 
remember that thing, dimly in the past, like last May). 
Actually, all humor aside, some of you may recall tlial 
Melrowerks shipped the DRl of a (axleWarrior debugger that 
actually debugged code tunning im Cofdand, back in May 
1996* That piece of code was probably the only piece ijf 
commercial .software ever shipped for Cropland — Trivia-end. 

l<hap.Sfxiy uses the Mach kernel, which is well im[)lcinenietl as 
originally dellntx! by Carnegie-Mellon. We are taking a dilTerent 
ap(m>acli U> debugging on iliis new optxiting system, actually 
peering into Apple's past and bringing .some very inteiesting 
ret hnology' to Ixiar on the problem, Fnan w'here ytiu might ask? 
Well, fn>m the work clone on l itxips by laligent. 

A very neat debug server architecture was develofxjd back 
then to run on top of AIX and to prtjvide debug seivkes to 
the n(x>ps environment. As part of our rekitk>aship and 
development agreements with Apple, we have licensed that 
leehnology am! are porting it to Mach. This debug server will 
allow botli full, one machine debugging as well as two- 
machine debugging Then we need to cliangc ihe hexst 
debugger to .support two machine debugging, but a lot of lliis 
original work was already done to .siippoit target debugging 
(MucOS hosted CW to NT, MacOS-hosled CW to IMayStatkm). 

So hopefully, youTI see a very clean, mexiern architecture for 
Rhapsody del)ugging tliat will work for pretty well any 
platform on which Rhapsexiy ruas. Of course, MeinoNub will 
conlinue to support Mac'CTS multi-language debugging and 
tile licx>ps mil) will do so for the new' OS. CcxleWarrior's host 
debuggers, whedier hosted on MacOS, Rhapsexiy, Win9^ or 
WinN'f or a linix platform will also be able to talk to this new 
delxig .server via TCP/IP. 


Dave: Haw will Ijititude and Equal fit into the picture? 

Greg: Metrowerks recently acquired tlie asseLs of the latitude 

Group wliich was essentially two prexluas: Ltilitude, a well- 
architected p)rting library and Hqtial, a 68K emulator, linked 
with tile Latitude lil>rar>'. We tiuty use ilie 68K emulator in our 
enilxxldtxl products at some later date, but riglit now, our 
immediate fcxais is on l-atinide* 

The really interesting thing alx>ut Latitude is dial it was 
arehiicxaed from the ground up to support the emulator. As 
such, it has a distinct design and has proven very robust in 
porting applications to iiNtx systems, sfKX'ifically Solaris, SGI 
and HP, In panicuiar, Adoix: used Latitude to jx>n and run 
Premiere on SGI and Idioioshop on Solaris. So we’re talking 
uhoui some very robust teclinology that is in current 
commercial use with two very demanding applic'aiioas. 
CuiTenily, The Litiiude Cross-Platform Development Kit runs 
on the following unix RISC work.siations: 

• Sun Microsystems SPARC, or compatible, running Solaris 
2.3 or liigher. 

• Silicon Graphics Indigo or indy w'orksraiions, running IRDC 
S.2 or higher. 

• Hewlett Packard Series 700 workstations, running IIPUX 
9.03 or higher. 

Altitude is a |X)rtahle ijiiplemeniation of Macintash System 7 
apfiliailion pnjgramniing inieriaees {APis), as documented in 
Apple’s Inside Maciniasb. Hie iaiiiude TeGinology forms the 
core of the Dititude Cross-Piallbrui Developiiienl Kit. Tlie Kit i.s 
a virtual porting system that allows .souae ccxle for a Macintosh 
applicadtjn to lx: com pi led with liitle or no mtxlitication on a 
UNIX platform, resulting in a tiaiive t'Ntx afipiicaLion. 

All applications creaied with latitude adopt the ]cK)k and feel 
of the destination plat form's (UlL The target GLJT (.such as 
GPFN LOOK or Motif) provide.s menus, dialog Ixixes, icons, 
scroll l>ars, and the like, but the application's content region 
retains the look and feel of the original Macintash program. 
Special Lititude provided lurictiutis allow develofiers to tailor 
the content regions .so ihat they loo can have the target GUI 
look and feel. LalitiKie uses indusrry-.standard interfaces 
including ANSI C. PostScript, and POSIX. 

Tile Latitude technology performs the functions of the 
Macintosh API througli a shareable ,sci of program libmries. 
Developed for accuracy and p<>rlal>iliiy, these libraries 
aecuraiely reflett the Ixdiavior of mexst of the Macintosh System 
7 RhjHxix. We!l-lx:haved Macintcxsli applicatioas built with 
liititude nm w'itli liule to no irnix ixming or citstomization. 

Written in ANSI C for P(3SLX-compliant platforms tliat 
support XI1, tlie laliitide technology is more that 9S% 



GRixi Galanos aki) thiv Mac^ DtmoPRK's Roadmap 


IvlAcTcaiMAOAZiNi- • May 1997 








independcni of the specific mix iiiiplcnientation, XI i 
libraries, and Gill under consideration. 

Dave: How about the latitude bridge to Rhapsody? 

Greg: As a result of the unique archifeciure of the latitude 

library, support of a new target like Rhapsody rec|uires tiie 
retargeting of around UK) Latitude calls, aixuit 50 user 
interface calls and about 50 iniiiging calls. The leason why we 
cat\ move 2000 or so Mac calls to a new largts so (juic kly is 
that the 2(X)0 calls all first target the Latitude jKjjiabilily layer 
which alrstracls out a lot of the Unget supjxm and only 
requires a subset of calls to be iniplemenied for a new target. 

Given this, we lx:lievc that Latilude can pnwide a very 
strong portability solution for getting Mac apps up on 
Rhapsody (or other supported hnix plarfomis) t|uickly, 
providing the Mac devei<?p<‘r with the ijpjxmunity lo 
execute a quick port to Rhapsody of their current 
application, call it a point release, and then to subsecjuenlly 
add in native service support for ihe target operating system. 

A Macintosli application that binds to Latitude will acquire the 
look and feel of a Rhapsfxiy applic:tiion as well as proiecied- 
memory. Adtliiiona! features, sueli as multi-tasking, can then 
l>e added through direct mixing of calls, some handled by the 
Latilude library, others directly by the mitive Rhapsixly APIs, 

As usual, it's only when we hnish the implementation c)f the 
Rhapsody taiget and use it ourselves that we’ll know if it’s a hit 
or not. We think it will be, given our diM:u,ssions with Adol>c‘ 
and Apple engineering. So, the first ihing well do is eat our 
own dog food: |x>rt CodeWarrior using Latitude. I lopefully, by 
the time you read this well have something to show y<Hi. 

We're h<?pefui we can ship die CodeWarrior Latitude HI IK 
later this year, around the s;ime time we ship the early 
releases of our Rhapsody rkiIs, 

Dave: How efficient will this approach be? 

Greg: llie best way lo answer that is lo kx>k at ap[)S tliat use a 

fKining library. First, we use die Mac2Wm library' Iroiii Aituni 
software to port CcxleWarrior to Window^s 95 and Windows NT. 
Given that die underlying file systems am native, and t!iat tltc 
winck>wy menu and dialog DLLs on Windows 95 and Windows 
NT are pretty efficient, we see no material slowdown in the 
Windows-hosted version of OxleWarrior. Given tliat die current 
Mac file system is emulated on Power Macinlash, we actually 
sex; a faster res|X)ase time on CodeWarrior for Windows and no 
apparent perhirmance ditterence between OxleWirrior using 
the Mac2Win library and native Windows apps. 

As far as tlie Adobe products are concerned, they nm much 
faster on SGI and Solaris workstations, the rc.suk lx)ih <m the 
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underlying t?Jvjx kernels anci the power of the worksuiiions. 
So, we see no immediate need for concern liere. Additionally, 
given liiai you can mix Liiitude and native calls, if you 
experience a slcvwtlown in a time-criiical routine, you am just 
aill the native API for that specific rotttine. So, instead of 
rew'riting it all, you fine tune tltc parts tliat need fine tuning 
once youTe up and running on Rliapscxiy. 

Of course, we view Laiitude as a transitional technology, li 
should l>c used for bring up on Rhapsody, and will not 
necessarily track all new Rhapscxly APIs as they become 
available from Apple. It will certainly he wonhwhile Ibr a 
developer u> implemem the second generation products 
for Rhapsody directly to the native APIs or to write directly 
to Rhapsody for a new' product. 

Dave: How will Latitude be packaged? 

Greg: Hie laTinxle SDK, w'hich will include all the sources to 

the bititude library as well as all the supported targets 
(Rhapsixly, Solaris, SGL IIP) in stxirce will cany^ a retail price 
of $399- It wjO follow' the QxleWarrior sulrscripiion model 
anti he updated tfiree Limes a yc“ar. Current CtKlcWarritx 
Academic cILscounts will alsti apply. 

Tlie new Rhapstxiy tools {CodeWarrior IDH and all the Um>1s) 
will l)c rolled directly into ihe CcxieWarrior Gold and 
Academic SDKs, so that all current subscribers will get the 
tfxils when they are available a! no atklilional cost. 

So, tlie Mac deve[o|x;r, armed with CodeW^anrior Gold or 
Academic and CcxleWarrior Luitude, with a little sweat 
equity" (Le. abour rhirty "burning ihe midnight oil' nights) can 
move ID Rliapsody fast, and wv mean last, without 
completely rew'riting their application. 

CcxleWarrior Rha[)s<xiy will use the Latitude techm^logy lo leap 
lo the new platfomi and lx* rolled into the QxleWarricjr SDK. 
Once CodeWarrior is up and running on the platform, we'll 
cxmtiniie abiding new features in the prtxlud tliat take 
advantage of tlie native Aids. We re also Liking a real hard look 
at InlerfaceHuilder to see wkit we need in the environment to 
offer compatible features. Of course, developc^rs will also lx; 
able lo use InterfaccBuildcr, Ix-caiLsc we aim to interoperate 
with ProjectBuilder and InterfaceBuikler on lihapsody. 

Daves Have you flrniccl up plans for your sixth lane, 
PowerPlant? 

Greg: Whar to do with IhwerPlani is a very inierL\SLing 

cjuesiion. Sliould we write a new version for Rltapsrxly? Wltat 
should it be w'ritten in? Should we write it in Java? Wltat alxjiit 
the MacOS version? A kx of tfiiesrions, many unknowns. 
Here's w'hat weVe decided to do, given ihc dual oixmting 
system strategy at Aj)ple and the current state of Java Aids, 
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One, we will conLinuc lc> enhanee PowerFlanr for MacOS 
for the duration* Two, the transition of FowerPtani-based 
apps to Khapstxly will be achieved by linking with tlic 
Latitude lil)rary. We will achieve proof of concept of this 
by porting QxlcWarrior, which is all PowerPlant code, 
using Latitude ourselves. Three, where Apple prtivide.s 
crt>s.s-plaiforin APIs betw^een MacOS and Rhapsody, 
support for these APIs will be rolled into Power Plant 
where it is feasible and necessary. 

Rhapsody already contains a very rich set of frameworks 
for desktop and Internet dcvdopinent. As such, it Is not 
currently planned to build a new version of PowerPlani for 
Rhapsody, but raiher to support Apple in its deployment of 
the Rhapsody AlTs. 

As far as doing a version of PowerPlant for Java, right now, 
weTe talking about a pretty crowded field from AWT 
(JavaSoft), IFC: (Netscape), AFC (Micro-soft), Javatems 
(JavaSoft), and tram likely a Rhapsody derivative from 
Apple. A conglomerate of Java APIs, Pven if we did write 
a version of PowcrPlaot in Java, would it lake hold? Would 
it be accepted as an industry standard as most of the 
systems vendors vie for leadership in the Java API space? 
The answer right now is no, so w'e're going to concentrate 
on the tools infrastructure for Java, hut will no* fiekl a Java 
framework directly. We will, however, [lupleineni 
necessary Java class technology in order to support our 
Java RAD tools development* It’s still too early to tell if it 
makes sense to make these Java classes available as a 
“framework*’. Well have to w^ait and see. 

Dave: Tell me about CW12* WhaPs new- in this release? 

Greg: We1! have a final release of the 2.0 IDF (new project 

manager, multithreaded, multi-taQ^ci, etc*) along with a pre¬ 
release of the 2.1 IDE which contains the iiitegrated debugger 
(allowing u*sers to m breakpoints directly from their source files). 

We’ll have a final release of tlie PPG JIT (Just In Time 
compiler), which gives greatly improved performance iwer 
previous versions, a beta release of the 68K JIT, a final 
release of the native Java compiler (i.e., noi an inierpreted 
Java compiler), and a release of tlie completely inLegraLcd 
VM contiiining the OBCl (Optimized Byte Cocle Interpreter) 
and JIT in a single Iknaiy-. This is the same VM with which 
Microsoft's internet Explorer ships, and will l>c^ our new 
redistrihtirahie VM version. 

We’ll ship a single Del>uggcT application for 
C/C++/Java/Pascal taigeting MacOS (68K and PPG) and 
x86 crt>ss debugging. 

ANSI C++ support wall be enhanced (explicit, muiabie and 
improvexi default template arguments). Well ship a 
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prerelease of our Objectivc-C compilers and linkers for PPG 
and x86, allowing users to .start developing for OPENSTFP 
and Rhapsody today from MacOS. Well ship a prerelease of 
IR optimizing 68K cx)mpiler, with greatly improved codegen 
(1(>-15% better ByicMark scores) as well as a prerelease of 
improved MSL C++ libraries, which along with the new 
prerelease ANSI C++ compiler, generates much smaller 
executables and improves compile speet!. 

Dave: Iti ihc same vein, what’s on tap for CW13? 

Greg: We’ll ship the release version of the 2*1 TOE, which 
lonrains the integrated debugger, new text engine, and 
pi>rtable project format (single project file will work on all 
supported platforms). There will be a prerelease of the 2*2 
IDE (with contains a “sneak peak** at our integrated RAD 
support) and a prerelea.se of the native Rhapsody IDE, 
which will run as a full fledged Yellow Box application, 
allowing users to develop and debug Rhap.sody appUcarions 
from within Rhapsody itself. 

We’li see continued Java VM/JIT performance improvements, 
as well as reducing si7*e overhead. Well add native Java 
codegen suppon allowing use of Java to target PowerPC 
native executaliles, giving greatly improved performance 
without the use of a JIT Wdl also ship a prerelease of a 
completely native Java compiler written in C++, allowing 
users to u.se Java to generate native executables for all Code 
Cienerators which are .suppt>rled by Metrowerks (currently 
68K, PPG, x86, and MIPS) 

CW13 will see improveri Java debugging support and two 
machine debugging, allowing u.sers to tlehug between any 
two machines running MacOS, Rhapstxly, and Windows. 

We’ll add name-spaces support in the ANSI C++ compiler, 
along with other C++ improvements and a prerelease of 
Direct to Ol^jeitive-C supj^^rt in the ANSI C++ compiler. 

Finally, we’ll ship both Constructor for Window.s (allowing 
users to generate Windows resource files visually from 
MacOS) along with a prerelea.se of Constmetor for MFC, 
which allows users to create their MFC views from within 
Cfiastnictor, and then have Constructor generate all the 
source needed to instantiate the views. Hi 
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Here’s a limited time offer that’ll have you seeing dcjuble. Order the MacTech CD- 
ROM™ Volume 11 and get the upgrade (expected release 1Q97) absolutely free! We’ll 
even throw in the shipping costs for the upgrade. And as if that wasn’t enough, 
Volume 11 is discounted too — now just $79! 


That’s right, so for less than you would nonnally pay for one CD... you’ll get two! 
So hurry, pick up the phone, fire up the e-mail, launch that fax machine, or simply 
drop by our Web site and score yourself this double-whammy of a deal! 

MacTech CD-ROM Vols. 1-11 

• 1420+ articles from all 127 issues of MacTech Magazine (1984-1995) 

• Improved hypertext and new THINK™ Reference Viewer 2.2 

• 100+ MBs of source code 

• Full version of THINK Reference 2.0 

• 80MBs of FrameWorks/SFA archives 

• Sprocket™! MacTech’s Tiny Framework that compiles and supports System 7.5 
features 

• The best threads from Macintosh programmer newsgroups, plus thou.sands of 
notes, tips, snippets, gotchas and much more! 



Web Site: http//www.devdepot.coni • E-mail: orders@dcvdepot.cofn 
Phone: 1-800-MACDEV-l • Outside the U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 












By Jessica Courtney 


Open Dinm Networks Ships HomeDoor 2.0 
Major new upgrade to industry-pioneering product 

Open Door Nerworks, Inc. announces tlie sliipincnt of 
Hc>[ncDtK)r 2.0, a inajor new release of the product that smrtetl the 
Macintosh multi-doinain Intemcl services market. HomeDoor 2.0, 
which works both conventionally and as a plug-in ftjr WehSTAR 
and compatihie servers, prtwicles Webmasters with unprecedented 
levels of flexibility in setting up mulU-drjmain Web sen'ers using 
the Macintosh. HomeDoor retnams tlie only Macintosh product to 
offer “any browser, any server^ compatibility, and with the 2i) 
release it Ixxroines the only pnxluti tr) provide Webmasters with 
the option of implementing eitliCT or Ixiili t}f the two nirrent 
mechanisms for providing mulii-doinain Web service. 

HomeDtx>r 1,0 pioneered the multi-domain Internet services 
market on tlie Macintosh by [>roviding Mac Webmasters with the 
ability to serve Web pages ff>r multiple indeixrndent domains fn)m 
a single Macintosh server. Apple Computer quickly recognized 
HomeDoor's value by l>undling the puKlud with its Apple 
Internet Server Solution soon after HomeDoor’s inux>dut'Lion, 
Open Dfxjr trontinued to grow the multi-domain services market 
through the introduction of its Ix>gD<K>r and MailDoor products, 
providing single server, real-time monitoring/kjgging and e-mail 
on a domain-by-domain basis. Most recently, Open Dcx)r intro¬ 
duced iLs Multi-dotnairt Wel>master Suite, an integrated set of 
multi-domain pnxJucts and accesst>ries. 

With the evolution of the World Wide Web and iLs underlying 
protocol, die HyfKTTexi Transfer Protocol (H1TF), a new tech¬ 
nique for providing multi-donuun Web service has recently 
Ixicome available. H'riT 1.1 includes a “hast” field, which enables 
an alternate way of providing rnulri-tlomatn Web service. The Inxst 
field is sent by most current Web brow.scrs, bui is not supported 
by some old browsers, including Netsatpe Navigator vcision 1.1 
and many America Online browsers. Nonetheless, in certain situa¬ 
tions, “hast field mapping" dtx-s provide advantages over the “any 
bniwser, any server" technique pioneered by HomeDoor 1.0 (see 
<http://www.opendoor.conn/MultiDomainFAQ.htnil>). To provide for max¬ 
imum flexibility, HomeDoor 2,0 offers the WebmasicT a choice 
Ixaween techniques on a domain-by-domain Ixisis. enabling 
Webmasters to “mix and match^ as desired, 

I lomeDtxjr 2,0 also includes a complerdy redesigned Admin 
applic'ation. Written fit>m the ground up as a full-fledgeil 
Macintosh app, HomeDoor Admin 2,0 integrates IxXh niull!- 
domain Web .service technif|ues through a single, consistent user 
interfac'e. HomeDoor 2,0 also incorporates new features, such as 
the ability to export configuration data to a taMelimited text file. 

All Open D<x)r prcxlucls, including Homet>oor 2*0 can lie 
ordered securely from <http;//www,opendoor,com/order.html>* 


APPREN^riCE 6 IS Now AVAnARIT! 

Weighing in at well over 6(X) megabytes, you’ll find hundreds 
of high-cjuality and up-todate source code examples. And all of 
tlie source ctxle is eitiier new or ufiducd for ihis release! Included 
are some of the coolest new code, designed S|K?cifically to demon¬ 
strate the latest teiiiniques, and all of the ccxie is in C/C++, or 
Pascal, using CodeWarritir, Symantec, and Ml^W. You1l find com¬ 
plete working examples of applications, games, control panels, 
extensions, utilities, and more. 

If you are new to puTgramming, the includtxl "frameworks” will 
help tremendously* These are complete program slielLs that take 
aire of many of the tedious tasks associated with Mac programming, 
including menus, standard diak>gs, file handling, and the like. 

Looking for liliraries or n>utines designed anmnd a spet:ific: 
task? Apprentice contains dozens of libraries and classes (including 
a complete suite of PowerPlant and 'lliink Class Libraries), from 
graphics and sounds to menu management :ind TCP/TP a.>mmiini- 
cations. Many of the libraries include complete .source code* If you 
are just looking for a small routine to do a specific thing, you 11 find 
hundreds ol' useful c<xle “snippets", small routines tliat perform 
s|xx:ific programming tasks. 

Programming languages interest you? I'here are over a 
dozen complete programming environments to suit any taste, 
Basic, Clcitn, Eiffel, Lisp, ML, M(Hlula-2, Python, and Tcl-Tk are 
only a few of tlie languages included. Most conic complete witli 
dtxumenuition anti programming examples, and some include 
complete source ctxle to the language itself. 
<http://wwwxe!estin,com/upgfade*html>. 

Roaster Technologies Licenses Objeci Design’s PSE i ok 
Java to Integrate with Roaster Reiease 3 

Roaster Technologies tcxby announced that Itaister Release 3 
will include Object Design's OhjectStore PSF. for Java. Katster, the 
pioneering Integrated Development Environment for Java on die 
Mataniosh, has added significant fiinciioniility by tightly integrating 
OhjectStore PSE into its new release. 

Written entirely in Java, ObjectStore PSE for java is a high¬ 
speed, small-fcK>tprint database that provides portable, trans¬ 
parent Java r>bjeti persistence. This integration will enable 
Roaster users to access data frt)m tlteir Java applications easily, 
without having to map Java objects to sequential files or tables. 
When combined with the ability of Roaster Release 3 to aeate 
stand-alone Java applications, die po.ssihiltties afforded Roaster 
owners by this tntegraiio!! are limitless* 

I'ktvelopers who use Roaster will liave the added bonus that 
Netscafx Ims licen.scd PSE hir Java for iniJitsion in their upcoming 
Communicator. Therefore, Roaster develo}Xjrs will lx* able to write 
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applets that allow users of Q>tTiiiiufiicalor to leverage the distrihuletl 
compiuing cnvininiiK/nl of the Web. 

In addition to licensing ObjectStore PSF. for Java, Raustcr 
’leclinologies will pon Ohjec:t Design’s OhjectStofc PSE Pro for Java 
to the Macintosh and a:scll it to Roaster customers, ObjectStoie PSK 
Pro for Java adds advanced transaction-level recovery and support 
tor multiple daiakises from a single application. Roaster's edition of 
ObjeciSion^ PSF. Ppe) for Java will l^e available soon for electronic 
[)urchase from a secure ccjmnierce server avaQable on the lioasier 
Website at <http://wwwjoasterxom>. 

Leverage the Powf.r of your AppieSc:ript and 4th 
Dimension Appucations with ScrifiAgent*. 

ScrjpiAgeni embeds AppleScript into die 4D procedural lan¬ 
guage, which enables 41) to communicate bi-directionally with 
virtually any AppleScnptahle application. 

A user can enter a crustomer code into a 4D layout, press 
Tab, and instantly return the matching customer record into 
the layout from an outside source (like MacP&L, an 
AppleScnptahle accxiunling application). Or build a complete 
publi.shing worldlow solution using QuarkXpress, 4D, and 
your favorite scriptable graphics cataloging application. 

ScTiptAgent works great with the new 4D Version 6, and wall 
provide die develofKT witli massive background proc'essing 
power using the new- EXECUTE ON SERVER command. 

Script Agent includes a complete users guide and tutorial in 
Acrobat format, luLona) sample application, and the 
AppleScript external for 4D. Upgrades are free of charge, as is 
Internet technical support, 

<http://wwwTrodenhancexom>. 

NEOUk;!!: Al)t;MElVTS CAFABlUTUiS AND ACCESSIBIliTY OF 

Objlo’ Database Technology 

NeoAccess 5.0 brings added performance, capabilities and 
full suppon for the latest releases of all majtir compilers and 
development frameworks 

NeoLogic Systems, Inc\, a leading provider of objea-orieno 
ed database technology, announced the relea.se of NcoAccess 
5.0, a significant enhancement to die company’s cross-platform, 
object database management system. Featuring added support 
for large datiibases (over four gigabytes) and expanded scliema 
evolution support, hJeoAcc:ess 5.0 simplifies the development of 
sophisticated applications for a broad range of professional 
developers. NeoAccess 5.0 includes full support for the latest 
releases of all major compilers and ap]>iicaiion frameworks. It 
ships w'ith full C++ source code to provide maximum flexibility 
for both commercial and corporate developers. NeoAc:ces.s 5.0 is 
available tfxby for Windtws. MacinLtxsh and UNIX platforms. 

NeoAcccs.s leduccs development time and costs for commercial 
and corporate application developers by offering fast .storage ami 
maruigement of ckitabiise objects in an easy-to-use class library. 

NeoAircess supjHuts all major compilers and application 
frameworks including Borland's OWL, MicrasofFs FnuneJation 
Classes and MetroWerks* Powerplanr. 


Applications built with NeoAccess lake advantage of its 
powerful caching system wliich keeps objects in memory, even 
after l>eiitg disposed of by the application, 

NeoAccess has been used as the Irackend database infra¬ 
structure for such applications as ClickWorks by Scitex 
Cor[x;)ration, NetObjects' Fusion by NeiObjeas anti the mail and 
newsgroup components in Communicator by NeLscape. 

A free evaluation copy of NeoAccess 5.0 sample applications 
anti source ctxle am obtained via the NeoLogic corporate 
web site at <littp://www.neologiccom>. 

VOOEKJO 1*8 INTEGRATES VERSION GONTROi. INTO 
CoueW.\rrior 

New release T8 of die popular version conutd tool 
VOODOO offecs scriptability and integration into Metrowerks' 
CodeWarrior IDE. 

LlNl SOE^IWARE PIUS uxlay announccxl llmt tite new^ vcision 
LB of iLs pcjpular version control tool VCX>L)00 will be rele;ised 
soon. In order to bring the new fejirures to the titsromers as stxm 
as possible UNJ SOF'IWAKF PLUS furthcT announced the immediate 
availal>iliiy of a full functional free pre-release of VOODOO 1.8. 

In version 1.8 the delta generation prex^ess has been 
improved again and is niut:h fasLer. Resides that, die new version 
supports even die comparison of files of different tyjx^s. 

Right now VCX)DOO can display the differences of text 
files, MS Word files and re,source files using different helf}€r 
applications. Other file types will follow. 
<http://www,unisoftxo,at/e/products/voodoo.html>* 

VOODOO Engine For OEMs 

In additkm to die full version contiol tCKil UNI SOFTWARE PLUS 
will soon release a “VtXTDOO Engine’’ wlikJi is a server application 
with an AppleEveni interface dial can lx*‘ tised to integrate version 
ajntrol furKtionality in oilier applk:ations, 
<http://www.unisoft.co.aVe/products/voodoo.html>. 

PreEab's Player 1.1 — Essential Scripting Utility Gets 
Even Blti'er 

PreFah Sr>ftware, !nc. aimounced iliat version i J of Player 
is now shipping. Player adds verixs to AppleScript and Frontier 
to query and control non-scriptahle applic:ations and control 
panels. 'Ihe 1.1 release offers new verbs, enhanced options, 
revised docuinentation and new example scripts. 

PreFab Player 1.1 includes a feature for automating Adobe 
Photashop. It is the only product on die market tliai can control 
f^h(Xashop dialog itents by name. Scripts can now “check'’ or 
“uncheck" a checkbox and ciU Player's standard query verbs, e.g. 
to verify that a certain item is enabled or exeaite a difference 
se<[uenc:e depending on wliich radio button Ls selected. Photoshop 
4.0 takes a preliminary step towards automation with biiilt-in 
“Actions." Player is .still rec[uired for the many real-world tasks lliat 
reriutre the flexibility of scripting. Over the coming weeks, PreFab 
will liighlight examples and customer success stories on its new 
website at <http://www.prefab.com>. ^ 
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TIPS & 
TIDBITS 


By Steve Sisak 



Fnj* Manager Tip 

If youVe got a prognim, .such as a compiler, which creates 
a temporary hie, writes and reads from ii, anti then no longer 
needs the data, don’t just close it and delete it; doing .so usually 
causes the temporary data to be written to disk. Before closing 
it, call S€tEOF(fRefNunn, 0); This tells the disk cache that none of the 
data a.ss<x:iated with the file need ever be written. 

Jorg Broum 
<hrown ^connect ix. c’am> 

Running m68k Codes ‘‘Compiled-in” (embedded) in a 
PowerPC Program 

Here is a tip I bumped into recently. I wanted to am a 
sequence of m68k instructions (actually, to perform a system 
trap) on a PowerMac. Usually, this is a trivial task: compile the 
code in the 68k universe (for example, with in-line assembly sup¬ 
ported by many m68k C/C++ compilers). From within a PowerPC 
application, one can call PowerPC glue code to the trap, which 
is probably present in the 'Interfacelib'. 

Unfortunately, neither of these easy options would apply in 
my case: 1 only have a PowerPC compiler (I don't have disk 
space to install both 68k and PowerPC parts of the 
CodeWarrior). The trap 1 wanted to call (^ReadXPRam), is not an 
“ofificiar one, thus there is no glue ccxle for tt in PowerPC 
libraries. Nevenheless, 1 found an easy way to run a .sequence 
of 68k codes “compiled in” a PowerPC executable, and pass 
data in and out. By die way, tliis i.s working code tliat prints the 
contents of the xPlUVM {more on xPRAM can be found at 
<http://pobox.com/-oleg/ftp/xPRAM.html>). 

// Printing out the contents of the xPRAM 

//The trick is Thai JeadXPRam/^WritcXPftaja traps are available only 
// from within 68K imivcfsc. So. if Uiis code rims in the ftiwerPC mode, 

// weVe got to switch imivcRics before running M68K code sequences... 

i/include (stdio.h) 
jinciude <Ki?tedHode.h> 


//This is 

// O Jl-I. TXl address would be 0 
// MOVEW S+(A7).D0 size -> !o word of UO 
// SWAP DO size ■> hi word of dO 
// MOVEAX 6CA7).A0 whciC '>A0 
// „RcadXPlkm 

// MOVEAL tA7)+Atl standard PASCAL epilogue 
// ADDQ.W^6A7 
// JMP (AO) 

// RTS 

//This is a sequence of M68SC instniciioijs; uafortunaidy. 

// a TViwerM^ compiler doesn't uodmiaod thou So we've 
// got to assemble by hand <s%h> 

// 

// m'W.lo write inlo aPRAM, Teplace OxAOSi in the sequence 
// below with OxAt)52 

//pascal void riead_extended_PRA]VI(char “ where, const short size) = 
static short read_extended_PKAM [] = 

I 0x4?.80* £>x302F, 0x0004, 0x2 06F* 0x006, 0x4840* OxAOSl, 
0x2O5F* 0x5C4F, 0x4ED0 J: 


#define C0HP_N0RET^2(naine. al. a2) \ 

nafliei(f#_procinfo - RPascslStachBased \ 

I STACK_RO0TIN£ PARAHRTPRU* SXZE_C00li(sizeof (al))) \ 

I STACK_K0tmH£_PARAMETERt2, ei2E_C0nK{sl2eof (aZ))) 

Ilfdefine RD_ALL0C(routine) static RoutineDescriptor \ 

routine# RD = BUILO0UTlNE_DESCRIPT0R \ 

Croutltie#_procinfo, routine) 


enun I 

COUP .N0RET_2(read_extendGd_PRAM,char *,const short) 

I; 

void iDaiii(void) 

I 

unsigned char whole_xPRAM buffer[256]: 

UnlversalProePtr u_read extended_PRAH - 
NewRoutineDascrlptorCdong (*) [)) rea{]_cxLended_PRAH, 
read extended_FRAl1_p roc info* 
kM68krSA): 

Ca11Unive rsalProc [ u_read_extended_PRAM, 
read_extended_PRAH_procinfo, 
whole^xPRAM^buffer* 
sizeof(vhol€_xPRAtLbuffer)): 
UisposeRoutineDescrlptor(u_tGad extended_PRAH): 

printf(“Vneontents of the xPRAM\n"): 

for(register int i”0: iCaizeof(whole_xPRAH_buffer): i+=16) 

I 

prinif{^\nX04x M): 
for(rcgister int j”0; j<16: j++} 
prlntfU%sX02x'', JX4 ^ o ? " “ ; 
whole^xPRAH3uffer fi+j ]); 
i 
I 

Olcg Kiselycw 
<oIeg@pohox.com> 






i U.V jpowr Qr imtal! B^iiMterBusError on your maebinef On ihe otkfer band, m might just pay you $25 for meb tip m use, or $50 “: ** 
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(...and we really mean now.) 


Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 

Mac'l’ech NOW " brings you up to speed on everything you need to 
know - instantly! And thanks to our new “fast-download” design, 
you’ll get to the information you want in seconds. 

Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge" section where you’ll get to 
bang heads with the best in the community. 

Log on to MacTech NOW. Things are happening right now, and you 
should be aware of them. 






Mitc'l’ech, MiicTech Magazine, MacTech CID-ROM, MacTech Web, THINK Reference, Developer Dep<^t, Sprocket, JavaTech, WebTech, 
BcTech, f^ovelopor Ccntriil, Vtmial Developer Central and the MacTutorMan arc trademarks of Xplain Corporation^ Other trademarks 
and copyrights appearing in this printing or software remain the property of iheir respective holders. 
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Dear Apple developers, 

You will be happy to know tiiat Apple Computer and MacTed) magazine have once again joined forces 
to ensure that you get the technical infomiation you need to successfully develop for Apple platfomis 
and to take advantage of Apple’s market-leading technologies. 

Starling with this issue oiMacTeeb magazine, Apple’s award-winning Technical Journal will be 
featured as a special section dMacTeeb. This means lliat develop will now be available to more 
developers than ever before. 

Long considered the definitive source for insight, code, and vital programming information on Apple 
platforms and teclinologies, develop will continue to be reviaved by Apple engineers to ensure that it 
retains iLs accuracy aiid robustness. 

And now, by being included in MacTed), articles will be more frequent and timely tlian ever before. In 
addition, dev(A(4) readers will gain all of tlie benefits that MacTed) has provided since 1984 - third party 
insights, advertising, product reviews, NewsBits and more. 

Combined, det)elop anAMacTech will provide you with even more of the high-quality teclmical 
infomiation you have come to expect from each publication - all in one location. 

So, whether you’re a fomier develop sutecriber or new to develop, we welcome you to MacTech 's newest 
section, and we assure you that Apple mAMaclkd) will continue to work together to provide Ajiple 
developers with infonnation to enhance your programming efforts and increase your productivity! 


David Kratliwohl 

Vice President 
Developer RekUimis 
Jpple Compuler, Inc. 


Neil Ticktin 

Publisber 

MacTed) Magazine 






by Hdward Voas 


Appearance: Not Just Another Pretty Interface 


Tb e Macintosh was once the mode! of 
consistency: every application behaved 
and looked I be same, making the user 
feel at home. But that consistency faded 
as, due to lack of support from the 
Macintosh Toolbox, developers created 
custom controls, menus, and windows, 
moving fortvard (or sideumys) with user 
Edward Voas interface inmwatiom while the MacOS 
lagged behind. Now the Appearance 
extension lakes the first step toward 
regaining that consistent look and feel 
we all remember so fondly, paving the 
wayforswHchahle inierface themes and 
making it easier lo develop applications 
for the MacOS. 

YouVe got this great idea for a user 
interface, but it means you iiave lo write a 
slider CDEF. Si) ytni plug away, working to 
replicate wfutt youVe seen in dozens of 
applicatioas, while dreaming of sliders tliat 
are available as pan of the system. Well, your 
dream has come tnie. Meet Apjit'iifance, the 
biggest advanceinent of the Macinuxsh user 
experience since System 7. The Ap|X"iirance 
extension provides sliders plus a lot more: 

■ Appearance implements a new kx)k — 
Apple Grayscale — which was 
originally slated to be the default lfx>k 
of Copland, the former MacOS 8 plan. 
Under Appearance the .standard system 
winders, controls, and menus all have 
the Apple Grayscale look. 


• Appearance adds new controls such as progres.s bars, talxs, 
disclosure triangles, and sliders tt^ the standard set, 
eliminating the need for develofjers to roll their own. 

• Ap[X?arance extends the Window, Controi, Dialog, and Menu 
Managers to provide funaionality that's necessary for some of 
the new' features to worit correctly. Some of the new 
functionality fills in the gaps that developers have had to fill 
in on their own because the Macintosh T(x)llx>x didn’t 
support some ntxressary or desirable features. For example, 
the system MDEF now supports extended keyboard modifiers 
for nienu item keyboard equivjileni.s. 

With Appearance you benefit the most by using as many of 
the syslem-.supy>licd user interface elements as possible. Your 
user interface won’t have a patchwork look — with the system 
elements, all pieces of the U1 blend together nicely. Plus, as 
Apple enhances the IJl elements, your applications can 
immediately (and automaticaily) benefit as new system versions 
are releasech 'fhis becomes particularly important as we move 
toward switchable themes (explained l>elow). Another major 
iKmefit is that your applications can lie smaller, because you 
don't need to implement UI elements that are now supplied by 
the Toolbox. A sample application that demonstrates 
Appearance can (>e found at <http://www.mactech.comx 

Apple intends to supply an Appearance exlcntion to be 
bundled with appiicaiioas for users la install on MacOS 7.6 or 
earlier (later systems will contain the fimctlonaiity of the SDK a.s 
part of the base system). Your appliaition cran detemxinc whether 
Appearance is running by checking a Gestalt selector 
(gestaltAppearanccAttr). This selector returns a bitfield inditrating 
wdiich features of Appeamnee are in efleci. 



Edward Voas (voas@apple.corn) is a .staunch su[rporter of Tmth, Justice, and Switchable 'llienics. He is currently the Technical 
Lead on Appearance and is the co-author of the yropular shareware program Aaron. When Ed is not busy axling, he is liard at 
work memorizing lines from the .Star Trek movies and Ixiring his coworkers with inane fatxs from those movies (“What’s the 
prefix code of the U.S.S. Reiiant?"). 
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The ON’Rvmp to Tiulwes 

You may have heartl nbcmi themes at A[iple's World wide 
Developers Conference (WWDC) or read ai^out them in 
discussions on Cr>pland. tussentially, a tlieme is an interface kx)k 
that spans all elements of the user interface and lies iheni 
together with a certain gra[)lsic design. I'hemes aa^ data driven 
— all the data tliat descrihes the theme interfatT? is contained in 
a theme Hie. 'Fhe tiata-driven as|xxt makes it easy to switch 
themes on the lly. Figure 1 gives escamples of three ihenies that 
were shown at the 1996 WWDC and elsewhere; Apple Grayscale, 
Gizmo, anti High 'lech. 



Now Ixfore you get itx) excited, please note that the theme- 
switching mechanism isn't implemented in the first version of 
Appearance; hf>wever, switchabie themes arc very miuh a part 
of the future of ilie MacOS. Appearance is the first step toward 
that future, and losing tlie system controls, windows, menus, and 
oUicT features provided by Appearance will alltnv yotir 
application to handle ihenie switches automatically when the 
time comes. I'll l>e referring lo Lhcme.s throughout this article, 
especially when talking al^mt the Ap^tcarance Manager, which 
lets you get colors anti panerns for the current theme. 

What's New^ and Improved 

Appearance redesigns some old controls and provides many 
new ones. WiikIows S|>ori a new look anti added features, and 
there’s a new help icfxi. Here well check out these snazzy Apple 
Gmyscaie UI elemcnl.s and learn a hit about t!ie new feaiiia.‘s. 
Then well kxjk at the Appearance Settings control panel, whicli 
lets the user control theme variations and the sy.siem ftmt, among 
other things. In laicr .sections, well descrilie how the new 
features work and wliat you neixl to do to adapt your 
applk:aiif>ns ff>r Appearance. 


• [N MacTecmMacvazini-: 


New CONTROI5 

Many ne%v controls are added to the system with Appearance. 

Bevel button control 







Text & Grapliie 


The bevel ImiEon t cjntrol implemems a rectangular btiUon 
with a beveled edge. Typically, a Ixvel button displays an icon, 
but it can display an icon, a picture, or (ext, singly or in 
conibinaium. You can also attach a menu to this control. 
Multiple bevel iliicknesses and several different button 
iH'haviors are .suppoited, to suit just iiIkhu any tise. Ihis 
versatility makers Ixvel buttons well suited for use in toolbars or 
ttK>l paleUes. (These buttons should never lx? used to replace 
pu.sh buttons, however.) The sample application accompanying 
this artide .shows many different variations of bevel buttons; 
you’ll be asiounded by the possibilities. 


List box control 




Intra-Ship Transport 


Hold In Pattern Suffer 

s 

Molecular Resolution Transport 


Molecular Dispersal (Ouchl) 

[lEJv 

Diofilter 



Tiic list box control implements a simple list box. Tt 
recj Hires an auxiliary^ resoune of type' Ides* to specify the 
features of the list, such as the numlxT of coltimns and rows, 
(The .Appearance Settings control panel, shown later, provides 
an example of columns in a list box.) This control allow-s 
filtering of key!x)arci events, and liandtes the default keylxtard 
navigation you'd expect from a list box. 

Note that if you use the list box control in a dialog, it 
won't respond to keyboard events — you can'i tab into it, for 
example — unless the dialog has established aii embedding 
hierarchy (described later). There’s a similar restriction on the 
clock and editable text controls. 

Clock control 


12/30/M 


rhe clock control provides an editable date or time field, 
as you'd find in the Date ^ Time control panel. The little 
arrows next to the ckxk are part of the clock control, 
(liemeniben you won't be able to Uif> or type characters into 
ilie (l(K‘k control unle.ss the dialog has csLal>lishcd an 
embedding hierarchy.) You can also specify a noneditable 
version that simply shows the dale or time. The noneditalile 
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clock permits live updating, so you can put a clock in your 
interface and let it tick away. The clock control uses the date 
and time formats set in the Date & Time coniroi panel. 


Slider control 






Impulse 


Warp 


Sliders are finally part of the MacOS repertoire. You can 
chocDse which way die indicator faces or use a non-directiunal 
indicator You can also specify whether to draw tick marks. Ihe 
slider supports live feedback (dcscrilicd later). 


Image well control 



This ccmlrol holds an icon or pknrire. In Apple Grayscale, 
image wells kx>k like an editable text box with a picture inside 
instead of text. Image wells liave a normal and selected stale, 
as shown aliovc. A good use for an image well is as a drop 
target for images or document icons. Drag and drop support 
i.snt built into this version of Apjiearance. 


Little arrows control 



Tlie little arrows contrtil implenicnLs die little up and down 
arrows you c)fien see tied to a Ixix displaying a value. Tiie arrows 
are used to increase or decrease the value. In the Memory coniroi 
f)anel, fur example, you click them to set the cache size or virtual 
memory partition 

Prioress bar control 

I ■ 1—1 [ ^ 

Progress bars are now part of the suindard control set. You 
can tell a progress bar to switch inU] indelermirtalc mode, in 
which it displays an animated barber pole-tike bar- you might 
use this mode to indi(.:ate that you liaven’t made a connection yel 
or are wairitig for some piece of data before continuing. Because 
the indetemiinate flag is separate from ihe value, you can switch 
back and forth without affecting llie value. 

Chasing arrows control 

0 0 c o o o o o 


Tliese are the spinning arrows that usually indicate an 
asynchrontms prtxx:s.s. In other words, tliere's something going 
on in the Irackground but you can eoniinuc to work. YouVe no 
douiii seen them in Find File when searching for files. 


Tab control 

J What \/^ When~^\/^otificatkiti^ 


] 


Currently, the new tab control supports only one row of 
tabs running along the top of die control. Future versions will 
support more variants. As with the list box, you use an 
auxiliary resource to specify the cab names and any icons that 
appear beside the names. 

You should try to restrict your use of tabs to those times 
when they’re really ncxzessary. Too many tabs can result in a very 
complex and confusing UL Also, tabs can lie difficult to localize 
for different script systems: the width of a text .string can incTcase 
up to 50%, ousing problems if you've set up the tabs to fit 
perfectly in a Roman script system. 


Group box control 



The group lx)x amtrol implements two group lx>x kxjks — 
primary and secondary, as showm aix)ve. ll also provides three 
dilTcrent types of titles for the groujx?d items — text, checkbox, or 
pop-up menu. Tlie pojvup title is useful for paged interfaces, such 
as the Sound and Speech control panels. You can embed other 
controls within the gnaip box control, sucli as radio buttoris. 

Primary groups slK>uld lx* used as the first level For grouping 
items. Secondary groups should always be inside primary group 
lx>xcs. The only exception to diis is if the group box is being 
used for a border anmnd some text, as shown above. 

Disclosure triangle control 

► ^ ^ 

You can use the disclosure triangle control in places where 
you want to liide some information to reduce clutter but still give 
ihe user a way to view it. The user clicks tfie disclosure triangle 
to cxjxtse the hidden information. The Finder uses disclosure 
triangles next to folder icons when in list view. 
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Window header control 


IQiiems .13I FlB»v^11oble | 

Itic window header control is what Llic Finder uses to 
draw the header of a window where text such as the disk 
information is slujwn. Text sold separately. 

Placard contro] 



'i'he placard control iiiiplcmenis a stnall panel like those 
often ftiiind at the bottom of a window to the left of the 
horizontal scroll liar* You might have seen them in 
Code Warrior. You could use a placard control to show 
information such as the current line number, as shown alxjvc. 
In Apple Grayscale, placards look the same as the window 
header control, but this won’t be the case in all themes, so he 
.sure to use the appropriate control. 

Visual separator control 


event filtering and supports password entry'. (Like the list box 
and cl(K:k controls, if you use the editable text control in a 
dialog, it won't respond to keylx>ard events unless the dialog 
has established an embedding hierarchy.) 

The text in the ctrntrol is always displayed on a white 
background in the Apple Grayscale ihctne. The figure above 
shows three editable text controls, one using 
the password entry variant. The ct>ntrol accepting passwords has 
the current keylx)ard Rx:us, as indicatetl by the ring around it. 
(Keyboard locus is described later,) 

Static text control 

Online Offline 

Static text controls replace the old .static text items for 
eml)edding static text in dialogs. Since they're controls, they 
can he deaetivaied and will then be tlrawn disabled like odier 
deactivated user interface elements. If you have a dialog with 
static text items in it and establish an embedding hierarchy 
for that dialog, the static text primitives will automatically 
become static text controls. 


Tlte visual separaujr ctmirol implement.s a simple divider line. 

CONTROI^ TO REPIACE DIALOG PRIMII JVliS 
Dialogs can amtain many items that are not controls — 
pictures, icons, editable text, .sUitic text, and user items. I'll be 
referring to .such items as dialog primitives. Some of these dialog 
prinuiivcs now have control counterparts. For example, the 
counterpart of die editable text primitive is the editable text 
control, which is a control with all the functionality of the 
editable text primitive. In referring to items in dialogs, the word 
control refers only to items diat are not primitives. Using the 
new controls allows you to take advantage of features provided 
by Appearance^s embedding hierarchy. 

If a dialog has an cmtK'dding hierarchy, the controls 
discTissed in this section automatically stand in for tlieir 
primitive counterpaits. Sf) the easiest way to use the controls is 
to let the Dialog Manager conven your primitives For you. You 
don't have to change your items into resource-based conlroLs 
and create ‘CNTl.' resources to use these controls (though you 
could if you had your heart set cm it). 


Fxlltabic text control 


__-- • ' . _ _ . ... I 

• develop 

■1-1_1 

; develop ’ - 

. m m m m m i * ^ ‘ ... 



'I'he editable text control replaces the old editable text 
dialog item. Because it's a control, it can be enabled and 
disabled. If you've ever tried to disable an editable text field in 
a dialog, you know how difficult tliis can \xi. Willi Appearance 
it's one line of code, 'llie editable text control allows keyboard- 
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User pane control 

The user pane control rejtlaccs the t)ld user item constnict 
in dialogs. Ihis control is essentially a stub coiUro! that calls user- 
installed prticediEres to tlo its drawing, liit testing, and other 
things that controls do. It also lets you track the mouse and draw 
with the correct highlighting —normal, highlighted, or wIiatevcT. 
Even in its mexst basic form, the user pane is very useful because 
you can emlx:d controls within it, whit h allows you to group 
items. When you hide, show, enable. t>r disable the user pane, 
the grf>up of embedded controls will follow suit automatically. 

Icon control and picture control 

The.se controls were created to stand in for icon and picture 
primitives in dialogs that havt‘ an emlxftkling hierarchy. 1'he icon 
control allows you to display icon .suites, as well as the usual 
'ICON' and ‘cicn’ icon types. When used to simply t^^place tlie old 
icon or picture primitive in dialogs, tlie.se controls don't track the 
mouse (they behave as icons atid pictures always did in dialogs). 
You can create an icon or picture control and add it to a dialog 
through a 'CNTL' resource if yoifd like it to track the mouse. 

Cflanges To Old Controls 

Some old conirols have a new look, more features, or both. 


Pu.sh button control 


( Enga^ I 


Engage 






Button controls — now called push burton controls to 
distinguish diem from l)evel button and pop-up burton 
controls — have been changed to allow you to set a “default 
button" flag. When set, this flag tells the control to 
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aytomiitk'ally draw the default ring (border) around ihc puj^h 
button. The default ring is drawn ouLside the contrors 
bounding rcetangle. The default push button has a new look, 
as shown in the last two examples above. 

Radio button control 

®0n QOff Q Mixed 'Q Disabled 

Ratlio buttons Itave a new ltx>k. Tlicy also support a mixed 
state. A mixed state Ls typicdly tised when a radio bititon represirnLs 
a selection that includes more than one state. Let’s s;ty you luive a 
group of radit) buttons that rey>rescni dilTerent planet classes: Class 
M, Class P, and Class K. As a user clicks a planet in a list, the radio 
buttons reflect the class tjf tht' selectetl planet. Nt>w suppo.se the 
user seletts tVnir planets from die list Ixix at once — for example, 
one Class K and three Class M planets. You can reflect tliis situation 
by putting the Class K and Cla.ss M radio buttoas in a mixed state, 
indicating tfun some of the .selation are of litis ty|x% but not all. 

The kConlnilRadioButtonMixedValue constant is for setting 
the mixed value of a radio button. You can use it in a call to 
SetContro!Value to set a radio button to the mixed stale. Your 
radio button must have a inaximum control value of 2 for this to 
work, .since that's die vaiue of the constant. 

Checkbox control 

□ Run Level 1 Diagnostic 

□ Use MilliCdthranes 

0 Rotate Shield Nutation 
0 Ignore Physics 


Our old friend the checkbox sports a new Icxik and real 
checkmarks, llie “X'' variant of this comroi is still available for 
use in caumries oui.side die IJ.S. like radio buttons, checkboxes 
support a mixed state, as shown in the Ignore Physics checkbox 
afxive. The constant for the checkb<ix mixed value should look 
vaguely familiar — it's kConiroICheckBoxMixedValue, 


Scroll bar control 

Scroll bars have a new look, tcxi. One scroll liar variant 
supports live scrolling. 


Pop-up button control 


System Font: 


^ Charcoal 
Chicago 


'rhe pop-up buUon control is the old pop-up menu control 
with a new Itxik. 


The new Help icon 

a 


There's now a systetu-.supplied help icon. You can 
combine tliLs with a bevel button to get the new standard help- 
button look, the Standard A len routine (described later) uses 
this approach to display its help button. 


Changes to Window Appfaran(x 
A ppearance gives windows a new kxik, as .shown in Figure 
2. (Ntite that floating window.s are now called utility window^s.) 


Cdlaptt box 









' 5 • ^ eg 

n«;_ 

-- r -Cl 0 ■'1 - :r , . . . 

• • C e- tr r - . 






S*andbrd nrKxid dialog window 

SkmdonJ moAibfe modd diabg w4ndCT« 


Figure 2. Standard Af^amnce windows. 
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Figure J, Ihe Appecirancc Settings ayntrol panel 


The? .stiindHrei document window lias a thicker i>cjrder than it 
ujicd UK This border is functional: it allows you to ^rab the 
window and dra^ it hum any side. Alerts are distinguished from 
dialogs by a red border; the new movable alerts also have a 
reddisi) litle bar (giving new meaning to the terni red aleH). 
RememlXT to use alerts only to warn the usc^r of something or 
to present impe^rtant information; in all other cases, use a dialog. 
The many window variants are descrtlicd later 

Document windows (and utility windows) also have a new' 
element: the collapse box. Clicking it t:ollapsc^s the winclow^ into 
a title har You may w'onder why the new' collapse box is where 
the zcxim box uscxl \u be and the zoom box has moved over For 
consistency, the most freciuenlly used widget is alw'ays on the 
outside — in this case, the collapse lx)x. (More windows have 
collapse^ Ixjxes than have rsyom lx)xes, and no window can have 
a zoom lx>x without a collapse lx>xJ 

Alscx the size ix>x is now integrated into the* frame of the 
w'indow. If you're ackipting these new windows directly (as 
descril'ied later), the size box is drawn For you automatically. You 
don't need to call DrawGrowIcon. 

Tilt Appearancf SmriNGS Control Panto. 

■[tie new Appearance Settlings control panel (Figure 3) 
allows the user to control these settings: 

• Tlie accent color of the current rheme. IliLs affects the 
coloring of menu items as iheyYe chosen, scrtrll bar and 
slider indicators, progress bar indicators, and Uxim rings, 

• The higlilight colix. Tttis affects the coloring of any 
highlighted itent ■— for example, selected text. 

• Window^ collapsing. When Appearance is mnning, the 
WindowShade control panel Is removed. When Double-click tide 
bar to collapse" is checked, the user t:an double-click the title bar 
in addition to using tlie collapse box to collap^se^ a window. 

• The system font. The Apple Grayscale system font is 
Charcoal, but users can chcxjse the Chicago font if they want. 

• System-wide Grayscale Appearance im)de. When ''System- 
wide Grayscale Appeamnee" is checked, it measts diat every 
application gets die Apple Graysc'ale look; otherwise, only 

appllegations that have ex]:)iicidy adopted Appearance's 
features have the Iwk. 


Not Your Tatiier’s Ointrol Manager 
'lb make the new controls work correctly, it was necessary 
to atld some features to the Control Manager The Control 
Manager now dtx:s die following: 

• Supports emliedding, to make drawing order anti It it testing 
p red ill able and enaf>le some Appearance features. 

• Sup|X)rts kcylxrard fcxais for controls. 

• Makes it easy to gel and .set control data and chfKxse fonts for 
control titles. 

• SupjKjns live feedback h>r scroll bars and sliders. 

• Provides a mechaoisiu for txjnirois to advertise the features 
that they support. 

Dilwung Order and Hit IYstinc 
From the very beginning, the order in which conirols draw 
in a window has been backw^nrd.s due to how the Control 
Manager manages ilic conUt>l list for a window'. As controls are 
created, they’re added to the head of a window’s control list. 
When the t:onlrr>ls are draw'n, the list Ls traversed, yielding a 
drawing order optK)site to the ortler in w^hich they were added to 
their owning window. To confuse tilings more, in norma! dialogs, 
dialog primitive.s, such as editable text and static text iiencs, aie 
always drawn fram Rrst to last When you have a mixture of 
contmls and dialog primitives, the pri mi lives ane dnjwm from first 
iu la.si after all the controls are drawn fiom last to first. 

This isn’t a problem if you can assume that controls donT 
overlap or contain other controls. With new controls such as 
tabs ami group boxes, however, you can’t make this 
assumption. Consider the ca.se where you want a tab control 
containing three radio buttons and an editable text field. Let's 
say you add them to the 'DITL' resource in this order; first the 
tab, then the three radio burtons radio 1, radio 2, and radio 
3, and then the editable text item. When they’re drawn, you 
get this order; radio 3, radio 2, radio t, tab, editable text. 
You’ve just covered up your radio buttons with the tab 
control (see Figure 4)! This happens because controls are 
drawn first, and then dialog primitives. Needless to say, trying 
to manage the drawing order can be difficult. 

Hit testing has similar problems w^hen items are inside tabs, 
group boxes, and other such conirols. Tlie FindControl routine 
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uses a linear search over die control list to find the first control 
that returns a part code other than kControlNoPart. This isn't 
always accurate, as disabled controls are skipped even liiough 
they were hit. FindDialogiLem also uses a linear search of the 
diak>g items, and stops when it finds the first enabled item that 
a given point is in. Consider what happens with that tab control 
with the three radio buttons if your application calls 
FindDiakigltem witli a point that’s in one of the radio buttons. 
FindDialoglteni never finds the radio biitron because the first 
item searched is the tab conirtil. The point is certainly within the 
tab control (the radio button is inside the tab), so FindDialoglteni 
returns the dialog item number of the tab control. The right 
approach is to do an “inside-out’’ hit test to find the most deeply 
nested control hit by the mouse. Read on to see how Appearance 
makes tliis possible and simplifies managing the drawing order 

The EMltEDDlING Hierakciiy 

To make drawing order and hit testing predictable and 
easy to follow, we’ve added an embedding hierarchy, where 
controls can be embedded within other controls, giving you a 
nidimeniary “view system." Embedding is a really exciting 
aspect of Appearance, The hierarchy ensures that parent items 
are always drawn before their children, li also helps hit testing 
.since the hierarchy can be traversed quickly to find out which 
control the cursor is over. A hierarchy can exist in any 
window. It's not restricted to dialogs, though ids easiest to use 
there, since the Dialog Manager deals with focus management 
and event handling for you. 

Root controls 

To enable control embedding in a window, you nujsf create 
a iKKJl control for that windt>w. The rexH control Is the container 
for ail other window controls. You create the nxit control in one 
of two ways: by calling tlie CreateRcx)tControl routine or by 
selling a dialog Hag to tell the Dialog Manager to create one for 
you (more on this later). Yon can’t emlied controls willKUil a root 
control, anti any auempi [o do so will result in all the money in 
your bank accounts lieing transferred into mine. Sti watch it. 

When a window has a rexx control, cnlLs to NcwCoiitrol (and 
GetNewContrf>l} aytomatically add conirols to the root of the 
window. Chilling Emlx^dCaMitrol or AutoEmliedControl is the only 
way to explicitly change llus. You use FniliedControl to s]:x:cirically 
embetl one control in anotlier. The Dialog Manager uses 
AutoEmlK-dConuol when arating items from a Dfll' resource. 

AutoEmbedControl uses visual placemen i to automatically 
determine what control, if any, a control .should l>e embedded 
within, based on Imunding rectangles. For example, going 
back to the tab and radio buttons in Figure 4, the Dialog 
Manager would have embedded the radio buttons and editable 
text field in the tab control for two reasons: they came after the 
tab in the ’DITX' resource and they fit inside the tab control. 
The ordering of 'OnV items is sriil important — a control can 
be embedded automatically only in a control that already exisSis 
— but the results are a lot more predictable with emlxjdding. 
Create your elements from back to front and everything will 
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Figure 4 The problem mth control drawing order 


fall into place. The sample code accompanying this article 
provides some good examples of how to dt> thi.s. 

Groups and latency 

The embedding model has many advantages, one of which 
is that it makes it possible to treat a set of items as a group. By 
acting on a common parent, you can move, disable, or hide 
groups of iicins. Disabling the root control of a window, for 
example, will disable all items in the window. 

Doing things like switching tabs Ix^comes remarkably easy. 
You can .simply use a blank user pane amtrol as the ct>mnion 
parent for all items in a particular “page" of a tab cxmirol After 
creating as many user panes as you have tabs, you can just hide 
one and show the next when a tab is clicked. All the contreds 
emiK'dded in tile user pane will lx* hidden and shown 
automatically when the user pane is hidden and shown. 

In hiding, .showing, disabling, and enabling groups of 
(‘onlrols, it’s imj>orUint to preserve the state of an item wfien it’s 
hidden or disabled so tlitii when its parent is shown or enabled, 
the item appears in that s;imc state. To acconiplish this, we ve 
added the ctmcepl of latency. Controls are considered latent 
when they’re disabled or hidden only Ixcausc tlieir parent 
control is disabled or hidden. IFs effectively saying, “This item 
should he enabled Cor sliown) when its parent is enabled (or 
slHJwn).” If you disable a control that’s latent, it Incomes truly 
disabled and won’t be enal>fed when the parent is enabled. 
Likewise, if you enable a control whose parent is disabled or 
latent, the control becomes latent until its parent Ls enabled. 

When enabling and ilisabling controls, to ensure that this 
latency information is always correct, you should use the new 
routines DeactivateConirol and Activate Control in.sicad of just 
setting the highlight with I liliteControl, as you undoubtedly 
have alw'ays done in the past. It would lx smart to use these 
routines even when no embedding or latency is involved — 
they'll .set the highlight ccxle corretnly and redraw tlie control 
For controlling visibility, the t)ld HideContro! and ShowConrrol 
routines have been modified to deal with latency when an 
embedding hiennchy is present for a window. 

Focus Management 

With Appearance, you can get and set the keyboard focus of 
a window. Hie control with the keylH>ard fix;us is the one diar 
receives all keystrokes. For example, llie Dialog Manager tesLs to 
see wliich control has the focus when a keyboard event is 
processed and sends the event to that controf It’s possible for 
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notliifig to have the focus, in which case the keystroke is sitnply 
discarded. As mentioned earlier, lu indicate that a panicular 
control has the keyboard focus, a focus ring Is drawn around the 
control, (fi’s a lavender ring by default, but the user am choase 
a different color in itie Appearance Settings control panel,) 

The keyboard focus routines introduced with the 
Appearance extension are available only when a root control lias 
been created for a window. In windows with an embedding 
hierarchy, you can use several muiines to get, .set, advance, 
reverse, and clear the keyboard focus. The default focusing order 
is a simple linear progression through all the enabled, visible 
controls in a window. The order is based on the order In which 
controls are added to the window. This is the same approach as 
using die order in which editable text items appear in a DITL to 
control tabbing order, (Evenlually, other system-supplied 
foc:using heuristics may be available, such as sf>atial ftxusing 
iliafs [>ased on the visual placement and grouping of controls, 
not on the order in which controls are added) 

Curreniiy, the controls that support kcylx^ard f(x:u.s are the 
editable text, list box, and clock controls. In future versions of 
Appearance every contnil ihai can receive user input will syppon 
keyboard focus (push buttons will, hoL visual separators won't, 
for example). You can plan for that day by ordering yout controls 
so that the focus will move from one to the next in the order you 
desire and by making sure they have cnougli space around them 
to allow for ftx^us rings. Ibcus rings are ouLsci a maxirnum of 
ducc pixels from die ctintrol's lx>unding rectangle. 

Getting and Setting Control Data 

Developers need to get and set different attributes of a 
control. In most eases, diese aurilxiies are unitfue to a particular 
control. In the past, the only way to allow access to cx^ntrcib 
specific information was to create a handle to hold such data, 
place it in the conirlData field, and publish the interfiice. A good 
example of this Ls tiie menu Imndle of a pop-up contnsL 
Unfortunately, this approach makes it hard to change the contml 
implementation in fuiure versions of the control 

In Appearance, we've added a nicdianism by which 
controls can allow the outside world access to their specialized 
data without cxyx>sing how it's stored. Itiis data access 
mechanism is the cornerstone of many of the new Appearance 
features, allowing you to get and set control fonts, user-pane 
callback functions, Ix^velbution image informadDn, and other 
useful things. Two new CDEF messages implement the data 
access mechanism: kControlRsgGetData and kControlMsgSelDala. 
To advertise dut a CDRF supports these messages, it must return 
kControlSupiXJTtsDattiAcccss in its feature flags. 

Eac!h piece of information that a CDEF wants to provide 
access to is referenced by a tag. A tag is some constant that 
is meaningful to the CDEF and represents the data 
in question. For example, to get at the clear text of a 
password field (the actual pa^ssword), you would use the tag 
kEditTextPasswordTag. To set the mdeterminate flag for a 
progress bar, you would use kProgressBarlndetenninateTag. 

Eacfi tagged piece of ckita can be any data type. It might lx: 
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a menu handle, a UniversalProcPtr, or a structure. It's up to the 
creator of die CDEF to define the lag and the data type for the 
data char's passed back and forth. 

To get and set data, you use the GetControlData and 
SetControlData routines, which use a format similar to that used 
by the Collection Manager and Apple evenls* These calls are 
pointer based, and storage is always owned by the caller, wliich 
means that if youVe trying to ger the menu handle from a bevel 
button control, for example, you would pa.ss in a p<:.)mter to a 
menu handle. To get a vital wari>engine matter/antimaUcr 
iniennix ratio from a control (a Fixed value, for those who don’t 
know), you migiit call GetControlDaia like ihis: 

Fixed theRatlo: 

DSErr err: 

Size actual Size; 

err = GetControlData{tiyControI. 0. kWarpIntermixTag, 
eizeof(tbeHatio), 

tPtrl&theRatio, CactusISize); 

Better font control 

Appearance allows you to set the font of any control title, 
independent of the system font or window font. Previously, your 
only choices were die system font and, if die control .supported 
that variant (and most did), the windf>w font. Now you can set 
the control tide font to any font your heart desires. 

‘lliere are also new constants available to take advantage 
of some system-defined fonts — big sy.stem font, small system 
font, and small emiihasizcd system foni, in the U.S, version of 
Apple Grayscale, those fonts are Charcoal 12, Geneva 10, and 
Geneva 10 bold, respectively. By using system<lefined fonts, 
you can be sure lo gel the correct font when amning with a 
different script system, such as Kanji. This helps your programs 
adapt autcjmatically to different locates. Never, ever hard-codc 
a font numlXT or font size. I mean it! 

i'D save you the hassle of setting control title fonts for each 
item after a dialog is CTeateci, we’ve added the new ‘dftb' resource 
type for a dialog font table. The 'dftb' re.source is used to specify 
the initial font settings for each item in a dialog. Tliis fesourcre 
run.s parallel to a 'DlTl' resource and has an entry for each item 
in a dialog. It .should have ihe same re.source ID as the 'DflL' 
resource for the dialog. Of course, you don’t need to create a 
klfrb' resource if you want to use the system or window font. 

TIktc's an old res(>urce — the 'ietb' resource — that very 
few people seem to know' about or use. The Icib' resource 
allows you to set Ihe font information for editable text and static 
text items, fnit not controls. Since it's now' possible (and 
desirable) to change die font of individual control titles, 
Appearance adds the new 'dftb' resource, The 'dftb' resource lias 
a slraighlforwaal resource formal, making it easier to create and 
maintain than the old *icti)' rcsourt:e. If a rltalog with no 
embedding Iherarchy has both a 'dftlV resource and an ‘icilV 
resource, die resource is used for the static text and editable 
text items oniy. if die dialog lias an embedding hierarchy, any 
1ctb' resource information is ignored. 
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rive scrollffi}; 

As Tncntiontx! earlier, Api:>earance allows you to have real live 
fcccll‘)ack witli scroll bars and sliders. With some ^'^ariants of tht: 
scroll bar and slider caintrols yim can scl an action [)nKcduiv to lie 
called buck as the indicator is moved. Each time the action 
pRxeduie is called back, the value (>f the contnti will intlicate whal 
pfxsiiion the user hits dra^^ged the indiaiior ttt. Listing 1 shows a 
gexxJ example of htiw to install and use a live Feedback crtllliack. 

Be sure you set the actif>n proc to be a ConTrolAclionDEE, 
not the DntgGrayKgnllEP that normal indicator dragging uses. If 
an action proc isn't passed into TrackControl or set with 
SctControlAction, no live scrtilling cxcurs — the control reverts 
to dragging a ghost of the intiicafor 

The control features set 

'lb get the ,set of features supported by a contrtjl, yt>u can 
call GetControlFejiiures, Tliis new routine returns a bitfiekl in 
w hicli each bit represents a feature the control supixtris, such as 
keyboard fexus or data access. If you w^anr to write a CDEF iliut 
supports any of the new fc^alures, ihc CDEF must res(X)nd to tlie 
kO)nm ilMsgGetFeatures message. 

Oil) Diacoc. MANACiFR, New' Trioks 

'I he new' MacOS user exf^erieace provided by A[ipearanee 
calls for some new' features to be added to the Dialog iVlanagcr. 
For example, you can now ask ihal a dialog’s background fit the 
theme, that a rcxti ctjnirol lx.' created for a dialog aulomatically 
when the dialog is creiued, or both, These feuiures are a^tjuesred 
through a bitfield W'here each l>it represcmis stime feaiure. This 
bitfield can be spedfied in two w-ays: llirougii the new- 
NewFcaturesDialog routine or in the new^ dialog and alert 
extension resources. In addition, the f>iaIog Manager provides an 
enlunced standard alert routine and lets you rct]uest siandaRl 
movaltle mtxlal Ixhavior for dialogs and alerts. 

New resource typf^ for dialogs Jind alerts 

To make it simpler and mtjre straightfoiward to add the new* 
Hags, weVe created two new' resource types to htikl extended 
information for dialogs and alens: cllgx’ and 'alrx'. These* 
resources spec'ify the feature liits and other inlbmiation. such as 
a window title for movable alerts. You relate these resourct*s to 
‘DLOG’ and ALRl ' resources by their II). [f you created a DLOG’ 
resource with an ID of 12B, you wt>Lild create a Tllgx’ resource 
with an ID of 128 to add extended inlbrmution. I'he Dialog 
Manager looks for a ‘dlgx' or 'alrx’ resotirce after reading in llie 
■DLOG’ or *A!>KT’ resource, 

Tlu>se w Ih> want to create dialtjgs [programmatically can ust' 
the NewFeaturesDialog toutine. NewFearures Dialog is kleniical 
to NewDialog (and NewColorDialog), except llial it lakes a flags 
parameleu Thc-se Hags are the same ones that you w'ould set in 
a *dlgx’ or *alrx’ resource. 

AuUimatic conlrul creafioii 

If you set tile features flag for automatically creating a rexjt 
control in a dialog, lx* aware that all ilialog primitives are 


replaced wath their control counierparts. The Dialog Manager 
routine GetDialogliem sfil) works as it always did: if you call 
GcLDiak>gIlem on a static text item, you’ll get hack a handle to 
text, not a handle to tlie control 'Ibis call has Ixen modified to 
sense when an emix'dding lucrarchy is [jresent and to calk to the 
contfx>ls to get the a]>prt>priale data. If you want to ac'cess the 
actual control for a static text item, you would use tljc 
GetDialogltemAsControl rouiine. You can then act on the item 
a-s you would with any control The SetDialogItem routine works 
as it always did except for a few' rest rici ions when the dialog has 
established an embedding hierarchy. In that case, you can’t 
change the tyjic or handle of a dialog item (except for user 
items, for which you can still set the ilmwing procedure). 

Converting dialog items into contiols makes it ixissible to do 
tilings you coukin'l do lx*fore. For example, when all dialog items 
are controls, you can highlight, enable, and disjilile everything in 
a dialog, including static and txliiable text items. Now it's as 
simple as a Citll to DL':iciivaieControl or ActivaleGoniiol. 

lu fact, wlien an emlsedding hiemrchy is e.stablished in a 
dialog, if you deactivate the dialog, all dialog controls are 
aiitomaiiaifly rlisabkxi. When liie dialog is reactivated, the items 
are reactivated. This is tlie desiied behavior and part of the new^ 
Human Interface Guidelines. Only the frontmo.si wintlow' should 
have active conirols and other tH elements. This helps 
distinguisii the active w'inikjw at a glance. Kverything else 
should fade into the backgroimd, so to .speak, so that the llsct 
can coiieenirate on the winck>w that's active. 

Tile iiioilier of all alerts 

11ie new' StaiidardAfen routine is possibly one of llie most 
useful routines in Appeanmee. It allow's ytni to .specify' the text 
of the alert and o[3tioiially some explanatt>ry' text. You can 
display up to tltree biiliftns with your c litace of text, as w^*IJ as 
a help button (see Figure 5). The alert autcKsizes itself based on 
llie amoum of text [lassed into it and also auto-sixe.s and places 
the buttoas. Standard Alert makes it simple to generate alerts w'lth 
the stancLird MacOS alert kxtk without using resources. 



Ion Storm Warning 

T ranaporti nq duri ng an ion storm can cause un predicts til? 
resulb. It might even throv some unliucky folks into an 
el te r rwite u n1 ve rse, A re yo u s u re yo ii we nt to do t hts ?’ 


[2 


[ Cantgi I 



Figure 51 Alert generated h)f SkuukmiAleil. 

Moveable Modal Dialogs and Alerts 
Appearance provides a standard movable nuxial Ix^havior. 
Instc-ad of liaving to write your own code for handling movable 
nuxlal dialogs, you can use the new movable-mtxlal flag in die 
Yllgx* re^source (or t^tll New'FeaturesDiakjg). The movable-modal 
flag tells ModalDialog to handle all the .standard user 
iiUeractioas, such us dragging a dialog by its title bar or 
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Listing L PnHJuiinif for a sc rtdl fmr 

ConLrolH.ind 1 c Croai r^MyLi vi^iSrrollPi^ir(WintfowPtr windDVj, 
Reef bounds. 

Slut 16 value, iiintl6 min, Sint 16 eleix. SinL32 
cefCon) 

I 

Contra IHaiidle control; 

c^onfrol ^ hJnwControl{window, hounds, "\p", trua, 

valun, min. max. 

kSldScrollburLivoPr tJt:. rorCori) : 
if (tontroi) 

Set Con c rolAc tion{control, 

NevCoutroIActlonProc CMySc roilEarAction))* 
return control: 

J 

pascal vutd MyScrul1 Bar Act hin{Con?rolHandle control, 
SiuLlb part) 

t 

SInt32 oldAb = SetCucrentAU(J: 

if (part kControiindicatorPart) 

P At this point, th<f value will bt updated t(j prrjperly refleet 7 
/* whore the user has scrolled to in our ini:ij;inar)' dociuncni. V 
Scrol iToLocation(Get€ontirol?alue {controi)) ; 
SetA5(oldA5): 

I 

void TrackMySctoiiBar(ControiHHiidie coiiTrol, Point 
where) 

! 

P Asjiuminj* the mouse w:ts elickcd in the indicator of a cimtrol, 7 
P you'd callTnick(lontrr>l like so: 7 

TrackControl (control, where, (ControlAct!onlTPFl' ID : 
/* You could ec^uatly its well have passed t he aeti<m proe in here 7 
P instead of caJibig ScrConm.ilActlon in CiTateMvLiveScrtdlBar V 

[ 


switching out of the application by clicking in another one, lt;s 
up to you to use the righl window type 
(kWindc>w'Moval)lcMcxlalDialogProc), 

To allow your application to handle events while the dialog 
is ypj yon simply pas.s in a ModalFilterUPP as you do wath 
Mt>dalDialog. One major difference is Uiat all events are passed 
to your MoclaiPilterUPP for handling; this alitm^s you to handle 
suspend and resume events w-^hen your applk ation is either put 
into I he background or br<juglii lu ilie from, as w'ell as any other 
events you might w^ant to handle, You could use tliis ability to 
allow your application to handle Apple events from other 
applications even i hough your aj^plicaiion is in a modal state. 

It’s just as easy to make your aleits take advantage of this 
movable modal behavior (see Figure 6). All it takes is a quick 
flip of a hit CkAlcTiFlagsAlertlsMovable) in the ‘alrx’ resource. 
This gives you the same behavior as setting the movable- 
modal Hag in the kllgx* resource. 



Figure 6, Standard movable alert. 
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Moving and sizing dialog items 

The MtweDialogltem and f>izel)ialogItem routines were 
added to help you keep controls and dialog item lectangles in 
.sync. If you call the old Mt)veControl and SizeControl rcjutines on 
a dialog item, only tlie control is affected, making it easy to forget 
to make conesponding changes to tlte dialog item rectangle, Phe 
neW' routines affect both the control and iLs dialog item rectangle. 

Window Manager Additions 
Not only dcx-:s the standard WDEF add a collapse ixfx to the 
title bar when Appearance is running, l>ut ihe collapse/expand 
mechanism is improved, Wind{)ws that support the new AJ^l 
actually remember that they've been trollapsed (except after a 
restarO, so when you hide and show an afiplication llte collapsed 
.state of those wandow^s remains intact, 

'Fhe tracking of the collapse box is handled by the .system 
for you. There’s currently no mechanism availalde to allow you 
to intercept tmeking, but we know it’s u.sefui and are working on 
a w^ay to make it available in the future. Calls to FindWindow will 
return the new widgel*s part ctjde, so your aj^plication should l>e 
able to deal properly witli part codes it dc^esn't understand. 

Appearance offers three routines for collapsing anil 
expanding w'mdows: Collapse Window, Col lapse AllWindtJws, 
and IsWindowCoilapsed. Tliese routines work only on windows 
tiiat actually support the new collapsing mechanism, How^ does 
Appearance know thc 7 supporl collapsing? As with controls, 
there’s a [icw message to which windows can respond by 
returning a bitfield of features. 

When a Wl^KF kas iht? Window Manager know that the 
window can lx: coilapscd (tlirough tlic feature bitfield), it c'an then 
Ix" collapsed i[i the pro|xr manner. I’he feature bit tells you that the 
window^ has a collapse lx)x, which serves as an ofwious widget thai 
ciin be clicked. Apfjearanec su[)pori,s collapsing by douhle<licking 
in the title bar of a window as well, but tliat’s not as obvious to the 
uscT, so it’s important to tllsplay the collapse tx)x. 

There are no new mes.sages to make a window^ calculate its 
regions in its collapsed state. When called with a wCa!cRgn.s 
message, tlte WDFi^' should check to see whether ii has been 
collapsed with a call lo IsWindowCollapsed and calculate its 
regions based on wdiatever it considers its collapsed look to be. 
Normally this is the title bar alone. 

SoMEiTUNG New on the Menlt 

Developers who use a custom MDEF may find that their 
menus lcK>k ooi of plac:e when running witfi Appearance, To 
avoid tills problem, Appearance extends the system MDEF to 
provide many of the features that developers have been using 
other MDFF.S for. Now you can set the font of any menu item, 
making WYSIWYG font menus simple to create. You can also set 
extended modifiers, command ID.s, text encodings, icons, and 
hierarchioil menuSj as desr:ribed below . In addition to tliese new 
feaiure>s, we reserved lwt> long integeis for your use, so that you 
can attach any other values you want to menu items, Fhese are 
called, remarkably, refCon and refCon2. 
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You can specify the features you want for your nienus cither 
by calling the new routines mentioned below' or by specifying 
the information in a new resource type (‘xmnu'). When GetMenu 
is called, the Menu Manager looks for a resource of type ‘xmnu’ 
with the same resource II) as the 'MENU' resource. If tlie 
resource is found, it sets the extended information for each menu 
item of die menu for you. After die menu is created, you can 
adjust the values with the new routines. 

Extended Modifiers 

You can finally attach extended keyboard modifiers to 
menu items. So go ahead and add the Command-Shtft-Option-K 
to your application tliat youVe been dreaming about. You can 
specify the extended modifiers in die *xinnu' resource or by 
calling SeiMenuUemMcxiifiers. Use the GetMenuIteniModifiers 
routine to get die eurrcni mtxJifiers for an item. 

You might wonder how those kcylnrard evenLs will get 
processed correctly. After all, MenuKey doesn’t have a 
nitKlificTs parameter. The answer is Menu Event, a new routine 
that takes a pointer to an event record. It returns a long 
integer as MenuKey and MenuSelect do, with the low word 
containing the item number of the chosen command and the 
high word containing tlie menu ID of I he menu containing it. 
If noiliifig was chosen, 0 is returned, 

Cominand IDs 

To help out frameworks and oilier teclinologics like 
OpenDfx, you can assign a coniinand 11) to any menu item. This 
lets you forgci alxiut ihe position of menu items. Instead of 
having to track down wliicli rneno item corresponds to a given 
menu ID and item numIxT, you can ust* the item’s ctJinmand ID 
to identify ii. Listing 2 gives an example of using command IDs. 
Assuming yuuVe set a different command ID for all your menu 
items, you am just call GetMenuIiemComniandlD to get the 
command ID and then perform the corresponding operation. In 
Listing 2 this is done via a switch statement. 

Text encodings 

You can set the text enc<jding for a menu item. Think of 
text encfxlingvS as script codes. ITeviously you had to set the 
keybfjard e<julvalent of a menu item to $1C and the icon ID of 
the item to the script code. Tlie $1C would tip off the MDEE 
that there was really a script code in the icon fields not an icon 
ID. Now you can set the text encoding in the 'xmnu' resource 
or call die SeiMcnuIteinTextEncoding routine. This enables you 
to have a text encoding and an icon simultaneously. 

Icons 

lb set an icon for a menu item, ytxi give it a handle to an 
'ICON', ‘SIGN’, or ‘cicn' resource or an icon suite. The 
SetMenultcmlconHandle routine takes a parameter to detemiine 
the type of icon liandle you're parsing in, and a parameter for the 
icx>n handle iLself. If you set an icon witli tliLs routine, it overrides 
any icon ID you may have set with SetMenuIlenilcon. Using the 
new routine also alkiws you to plot ‘SIGN' resources and 
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compressed Cl6-by-l6) ICON' resources and still have a keyboard 
equivalent. Prior to Appearance, you needed to set the equivalent 
to $1E and $1D, for 'SIGN' and 'ICON'* lespccdvely. Of coujhc, yim 
can also specify this information in the ^ionnu' resource. 

Hierarchical aienus 

Appearance offers an improved method for attaching 
submenas to menu items. Previously, the only way to do this was 
to set die keyboard equivalent of die menu item to $1B and then 
set the mark cliaiacter for the menu to the ID of the submenu you 
wanted to attacfi. Now you can use the ‘xmnu’ resource or the 
new SetMeiiuItemHierarchicallD routine to set the menu ID of a 
submenu. Both allow you to use a full l6-bit integer for your 
submenu ID. Freeing up the mark character makes it possible to 
have a checkmark next to a liierarchical menu. 

Dressing Up wrra the Appearance Manager 

The Appearance Manager i.s yotir one-stop shopping 
center for getting any colors and patterns needed to draw 
ciinsistenrly with the current theme. In the first version of 
Appearance, the current dieme is always Apple Grayscale, but 
it's imponant to stan dunking about themes. With the APIs 
provided with the Appearance extension, you can get colors 
for such things as the active window header text or the inactive 
menu text. There are also .several patterns you can gel for 
dialog background patterns and die like. 

Gening Appearance Manager colors and patterns makes it 
easier to create custom defprocs for HI elements that blend with 
the theme. If you’re not using the Dialog Manager for certain 
windows, these routines can help you set your text color 
properly .so that it maicfies the current theme. 

Along widi colors and patierns, tliere are also routines to 
clniw Appeanmee primitives. Apjx^a ranee primitives (as opposed 
to dialog primitives) are such things as visual separators, group 
lx>x lines, placards, and Focus rings. The controls provided with 
Appe^amnee call these routines to help llieir drawing. You might 
also oil them to draw elements that match die current theme 
when you don't want to u.se a control. 

In future versions of Apjx.*arance, there will l>e routines to 
do high-level diings such as draw button backgrounds. Using 
such a routine, you could create a bun on with a specialized 
content type and lu* guaranteed that your button background 
W{)uld always draw correctly for the current theme. 

Adofiing Aefeakance 

Tliere are varying degrees to which you can prepare for 
Aptiearance. This section t'twers the basic preparations and then 
g(ve.s some specifics on using Appearance in your ajiplicaiion. 
The stimple ccxle accompanying thi.s article is a concrete example 
of an application that uses Appear^mce, so you can peruse the 
code after reading this .section to get a feel for how^ Appearance 
features are u.sed in an hcmest-to-goodness a[>j>lication. 

Never assume 

You should never assume things abotit the environment 
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Listing Z Using command IDs 

mt^nulD = lliWcird(tiietiuKesult) : 
itemNo “ LoWord (men^iResult) ; 

GetlienuIteaiCcuiimand ID (CetHHand le (mentilD)» ItemHo. 
^command); 

switch (coEDmand) { 

case kCnidQtjit: 

FrepareToQuit C) ; 
break: 

) 


your application is running in. Always use routines like Gestalt 
and those in the Script Manager to get information about the 
environment. Tf there's no direct way to get the information, you 
probaldy shouldn’t l>c doing whatever it is you’re denng. Let's 
look at a couple of examples. 

Window metrics 

Properly determining window^ metrics will lieip you fXJsition 
windows correctly, no matter what the window looks like. For 
example, in the past y<xi may have let your appikraiion blindly 
assume tliat the window lx>ix:ler is 1 pixel tliick or tlie title Ixir is 19 
pixels high. However, the struemre region of a window is controlled 
l>y the WDRF; and with Appearantie il’s not guamnteed to lie any 
particular numter of fiixeLs tliick. Ap[ile Grayscale Ixmlcrs are 
thicker than die old System 7 look, and when switcliable tliemes are 
Implemented, borders will vary by theme. Your ajiplication should 
be aliie to deal widi lliis intelligcnLly by gelling llic .structure and 
content rectangles for the window and using them to ctilciilate die 
width of the window Ixirder. listing 3 shows how to do tills 
properly. The .sample application lias a routine to si 2 C a window 
and sa a winder’s tx>unds; die code also shows what imikes die 
GetWindowRects routine tick, in case yoii^fe interested. 

Window variants 

"Be careful wiiat you ask for, you just might get it.*’ Many 
applications ask for a dcxainientPrcx: w4ndow^ type and then never 
call DrawGrowIcon lx;cause the window isn't sup|X)sed to have a 
size box. Itetter to ask for the variant you reiilly want — in this 
case, n{)CrowDocProc. As shown earlier, with Apple Grayscale the 
size box is part of tlic structure regirm. Because of this, die size 
box would be drawn autonxitically for a documentProc window 
type. We had to do some work to get around this for times when 
llie user is running in System-wide Grayscale Appearance mode, 
Using the correct window varkint is a step in the riglit direction. 
The Apple Grayscale WDHF has a set of variants that make it clear 
whether a window lias a size iK>x or noU 

Appearance Sawiness 

Now that ytiuVc got these assumptions out of the way, 
becoming Appearance-sawy is really not that difficult. Just do 
the following: 

• Call RegisterAppearanccClienl early in your application code, 
before you di'aw the menu bar or create any HI elements. 

• Use the new system-supplied w'indows, controls, and menus. 


• Use the new' kllgx’ and 'alrx' restmrees to supplement your 
‘DLOG’ and 'ALRT' resources. 

• Ln dialogs, change any user items that are now available as 
controls (for example, a group box user item) into controls, 

• Enable embedding and Appearance-savvy backgrounds in 
your dialogs. 

• Make your alerts movable, and use the new SmndardAJen; 
rcjutine whenever possible. 

• Use tlie Appearance Manager to get any colors and pattenis 
you need to draw consistently with the current theme. 

Tlie RegisterAppcaranceClient rtJuLine tells Apfxrarance tliat you 
want to map all calls to tlie classic defprocs (WDEF 0, for example) 
to the new dejpfxxs autoniatically. ihe routines that umslate iiom 
old to new form the compatibility layer, which is pjirt of the 
mechanism tliat jmxiuces ilie Apple Grayscale kx>k when \Systeni- 
wide Grayscale Appearance'" is diecked in the Appearance Settings 
control panel. So calling RegisterAppeaninceClient is an etisy first 
step in adopting Appearance. To adopt Appearance completely and 
take advantage of some Apjxsiranc’e featuies, you fuive to call die 
new defpRK:s directly, as descTibed in the following .seaions. 

You can phase the alx)ve steps into your apf)lication at your 
own pace, adopting Appearance as your schedule peniiits. It's not 
absolutely necessary to do everything at once. For example, you 
might have •some <liaIogs where you c’an add the new n.'stMirtre digx' 
type, flip tite rigiit feature bits, and be fully Appearance-Siiwy 
witlioLit doing any more work, d'hase would olwiously lie the ones 
to convert llnsi. Ilien you t:an go on to cither dialogs whcR? you ntxxl 
to replace old user iients witli tlie new contioLs. When I converted 
the Date ^ Time contit>l panel to use Appeiuance, 1 elimlnared all 
hut one of the tuser items (the menu Irar preview) Ix^rause 
Afipearancc pnwided arniroLs to replace them (group Ixixes, icons, 
list boxes, and so on), So take your time, but remember dial die 
scx3ner you adopt Appeamnee, the sooner your application will be 
ready for switchablc dienics when diey’ie released, 

Wlien converting ;in application, lx? sure to run Ap|3e;irance 
with Sysiem-wide Grayscale Appearance mtxle turned off. Turning 
tjff diis mode puLs your system Ixick into die old System 7 kx3k for 
applicaiion.s dial liaven't adopted Appearance, wliich makes it easy 
for you to tell where you've implemented The new look and where 
you still have work Lcj do. If you're running in System-wide Grayscale 
Appearance mcxle, you won't lie able to distinguish the changes 
you’ve made from diose performed auromatiadly by die system. 

CoMPAoeiLrrv Laver vs. Direct Adoption 

As you begin to adopt Appearance directly and rely less on 
the compatibility layer, you'll want to change tlie defpRic IDs for 
windows, controls, and menus to the new IDs listed in Tal>ie 1. 
Even when calling the new defprocs directly, your application 
.should always call RegisterAppearanceClient so diat system 
elements such as die Apple menu will diaw correctly. Read on 
about some differences you'll encounter when calling die new 
defprocs directly instead of going througli die compalildlity layer. 

Window variant codes 

I’he variant codes for the new WI^EFs are different from the 
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Listing ,i Using the structure region to fMxsilion windows 

void KovetfindovStruet (Wind owPtt witidow. 5Intl& horiz. 
Slot16 vert* 

Boolesn update) 

I 

Reel fil met Reel, euiitRect; 

Po in t 81 c uc t TL. c out TL: 

Slr»t32 diff: 

r Get the !»iruciure and eument rcttanjdtts in counlinafcs. 7 

GetWindovRecte (window* &structRect * &eoritRect): 

r (^eulate the dtiference between the top left of tbc conicnt 7 

r rcRion and the top kit of the stnietui^ region.*/ 

struetTL - topljfffl (structRect); 

coniTL * topLeft(contRect)^ 

diff “ DeltaFoint(contTL, struetTL) * 

f* Add Ibe difference, since MoveWimlow moves based on the 7 
r Ktpdeft corner of the content region, V 
horiz 1“ (*(Point*)&diffi*h; 
vnrt +- (*(Point*)Adiff).v: 

MoveWlndow(window* horlz, vert, update)? 

) 


codes for the old Wl)EFs* so you need to change any place in 
your code where you rely on a window variant* Variant codes are 
window-specific and don'l prrwide a generic way to determine a 
window''s features. To remedy dial* weVe provided a Ijeiiet way 
CO find out about window features; GetWindowFeatures, Tliis 
routine is the window version of GetControlFeatures; it returns a 
bitfield to help determine wliich features a window suppoits. 
Here are the bits that are cunently defined; 


enum ( 

kWindowCanGrow = (1 

kWindowCanKoora “ 11 

kWindowCnnCol= (1 
kWlndowIsMudal - (1 

kWindowC anGe t Win d owRgn = (1 


« 0 )* 
« D* 
« 2)* 
« 3)* 
« 4 )* 


kWindowlsAlert “ (1 C< 5)* 

kWindowHasTltleBar “ (l « 6)* 




and all that yoifve come to know and love about zooming aie still 
the same* Hic new^ lx>xcs are merely a way to visoaliy state that the 
zoom w^ill act in a particular way* For example* die Ajiplc Guide 
Ooiiiing window used for coaching a user colkipses down into a 
compressed version cif iLself (just the biilfons and topic ate visible) 
when you click the ztx>m Ikjx. TIic hoim>nEal zcxim Ixix w'oukl be 
perfect to indicate how the window will zcx>m when clicked. 

Size boxes 

Size boxes in standard utility windows are now il-by-11 
pixels. The standard scroll bars can be made to fit into this 
space without looking scrunched, as tliey'vc been diangcd to 
support this wndth us well as the standard l6-pixel width. 
When you use old defproc IDs and go through the 
compatibility layer instead of calling ihc new uiilUy window 
defprocs directly, the size box is 16-by-16 pixels* 

Although not recommended, it is possible for your size 
Ik)x lo appear clsewliere than in its new location as part of ihe 
window frame* To do this, you would use a window variant 
that doesn't draw a size box and then put your size box where 
you want it, but you’d have to handle hit le.siing yourself. A 
future version of Appearance will have a theme-savvy size Ik>x 
control that can be put anywhere inside a wandow^; for new. 
you 11 have to draw your own. 

Weirdness banished 

The new dialog WDHF metrics you get when adapting 
windows diiccily are slightly diffcreni from the old WDKF 


Table t* Old to new defproc ID mapping for windows, 
controls, and menus 


If a window doesn't respond to GetWindowFeatures, it's 
probably an old-style window and you should jusl use iLs 
variant code. 'Itie Appearancellelpers library tliat comes with 
the SDK includes a set of routines to make it easier to 
determine a window's features using the variant t'odc (for 
example, LsWindowMtxJal). 

Zooming variants 

What's not apparent from Table 1 is that there are actually 
two window definitions now, one for windows and one for 
dialogs. The utility window has also been split into two, one for 
the normal variety, the second for die side title-bar version. We 
did this to clean things up a bit and add new features. In this 
release, weVe impnived the ztximing variants. 

0 B SB mm 

Figure Z Zoom hfx)c varianLi. 

Notice ihai die new defproc ID constants say "KullZoom" and not 
just “Zoom.” Ifs now p(xs,sible to specify horizontal, vertical* anti 
full zoom. As a result, the zoom box is drawm differently for each 
variant, as shown in Ftgore 7. 'I'he part code5 tor the zoom Ixix 
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Old defproc ID 

New defproc ID 

documentProc 

kWi ndowG rowDocu me ntProc 

noGrowDocProc 

kWindowDocu mentProc 

zoomDocProc 

k WindowF u 1 IZoom G rowDocumentProc 

zoomNoGrow 

k WindowF u 1 IZoom D oc u me nt Proc 

dBoxProc 

kW indowM od a tD la fog Proc 

movableDBoxProc 

k Window M o vabi eM oda 1 Di al og Proc 

pkinDBox 

k W ind ow Pfa i n Di a tog Proc 

altOBoxProc 

k W rndowS h ado wO ia log Proc 

floatProc 

kWindowFloatProc 

floatGrowProc 

k W indowF loalG ro wProc 

floatZoomProc 

kWindowFloatFulIZoomProcID 

ftoatZoomGrowProc 

kWi ndowFbatFu llZoom G rowProd D 

floatSideProc 

kWindowFbatSidePnodD 

floatSideGrowProc 

kWi n dowFba tSideG ro wProcI D 

f batSideZoom Proc 

kWindowFloatSidefuJIZoomProdD 

f batSideZoom G m wProc 

k Wi ndowFf oatSi deFu lIZoomG rowProcI D 

pushButProc 

kC 0 n tro! PushB utton Proc 

checkBoxPrex: 

kContfolCheckBoxProc 

radioButProc 

kC on trol Rad ioS u tt onProc 

scroll BarProc 

kControlScrollBarProc 

pop upMenu Proc 

kCo n trol PopupBu tton Proc 

textMenuProc 

kMenuStdMenuProc 
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incrricii. Mtxliil and iiK)vai>le modal %':irianLs no longer have that 
weird 3'pixel pfirtitm o{ iIk' Mrutinre region ill at lcx>ked like part 
of the amieni region. Tliis nicaas you can finally run your 
content up to the edgt! of tlie window. It also means you w'on’t 
have any problems with a gray background and a white Ixmler, 
which would hapjxm if you unused the background gray yourself 
and didni use SetWinCxjlor to set the content color. Tm sure 
many of you have had to deal with this situation lx.^fnre. 

Fnabiing ditilog and alert features 

There’s a big payolT lo adapting dialogs and alem directly — 
you gel all tlio.se great new features descrilTed previously — but 
it involves a liiile moa" work titan adapting a nomwl window, Tt) 
enable the new feaumfs for a dialog, you eitfier create the dialog 
with NewKeatiiresDialog or, for resource-based dialogs, create a 
Yllgx' a'stmrce with tfie .same ID as the dialog's ‘DLOG’ resource. 
Both NewFeiiiuresDiak^g and the ‘dlgx’ resourt'e allow you to 
sfx:t:ify .some Hags that tell the Dialog Manager w^^la1 ftratures a 
dialog SLipyxms. i hese are the bits: 

enua [ 

kDlalogriagsUseTlieiLeBackgraiind " (1 « 0). 
kDUlogb'legsUseControlHiprarchy^ (1 << 1), 
kiUalogFlagsHandleMcjvabU'Modal (1 <( 
kniaiLi3gFlag.safieThetri?Cyntrois “ (1 « 

h 

The kDialogFlagsLIselhemeliackground bit tells the Dialog 
Manager to tnakc sure that the background t>f the dialog is 
painted in the right color or pattern for the current tlieme. llie 
kDialogFlagsU.sc^ConTrolHierarchy bit tells ifie i)ialog Manager to 
create a rtK>t contrt>l for ihe window and csialilish a control 
embedding hierarchy. The kDialogrlagsHandleMovableMcxial bit 
tells the system that if this diak>g is fronUntrst w^hen MtxlalDialog 
is calleth anti its window type is movalile mtxiah it should handle 
the dialog as tiescribed earlier in “Movable Mcxlal Dialogs and 
Alerts." Dtjn’t forget to set the kDialogFlagsUseThemeControLs 
t>it, or the Dialog Manager will create olddasliitined System 7 
controls on your nice gniyscale dialog. Ick. 

You cun make alerts Appeal a nee-savvy just by adding the 
new ‘alfX" resource and setting the right bits. If y<ju want to save 
some cmle, aill the new StandanlAlert routine to [iresent your 
alerts. If your dialogs are Rez-based, it's really easy to create new 
resources. The Ap]>earance.r file included with the SDK has the 
Re^i definitions of the new- ref«Rirc:e trail plates. 

Using embedding 

If you turn cm emlxxlding in a dialog or aleit, you may need 
to alter your ccxle to deal with the fact that all items in die dialog 
or alert are considered controls in that mode. The sample 
ajjplic'ation gives examples of how to code a dialog with an 
embedding hierarchy. A good example is the code liiat 
demonstriites StandardAlcm. llie sample code puls up a tiialog in 
which you can set the [larameters to a call lo Standard Alert. 
Because everything Ls a control, you can easily enable and 
disable editable text fields and groups of items, for cyxample. This 
results in the code for that sample dialog Ixang very small, 
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sitnpie, and stratghtforw'ard, especially conipared to what it 
would liave been if you had to do all those things yourself! 

With A[ifxarance's new controls, you should be able to 
eliminate most of the user items in your dialogs. This is a fairly 
straightforward process of changing the user items into control 
items, Rememfier that if your dialog has an embedding hierarchy, 
yon should change your user items to (ai the very least) user 
[lane controls. The callliack to draw Ls practically the same. 

Menus on the fly 

If you create menus on the fly and want to adapt them 
directly, you .should use the NewThemeMenti call instead of 
NewMenu, been use New Menu assumes MDEF 0, which forces 
you through the compaiiliility layer. You’ll find NewThemeMenu 
in the AppearinceHelpers library. 

So, what can you rely cm? 

One of reasons for adopting Appearance Ls to prepare your 
application for switchable themes. In an envirfinmenr where tiie 
entire look of the interface can change at any moment, it might 
seem that you have to be ready for anything. In some respects, 
that’s true, hut there are some things that you can rely on, 
rhese aren’t assumptions, they're facts! 

• Default rings and focus rings can be outset a maximum of 
3 pixels. 

• Edimble text frames, group box frames, and list box frames 
c'an be a maximum of 2 pixels thick. 

• Progress indic'ator borders can be outset a maximum of 2 pixels. 

• Metrics of controls are the same across all themes, though 
lx>rders, which are drawn outside a control’s rectangles, can 
change f<jr default and focus rings. 

• Window structure metrics actually do change. 

• The menu bar height can vary, bur will never be more than 
24 p>ixels. 

Thi.s ittformaiion is provided to help you by out your UI 
elements with enough room to look good in all tlicines. When 
theme-switching is available, an Apple event will infonn your 
application if a Uieme .switch occurs. Then your applkiition can 
adpist window' positioas to ac'commodate changes to window 
fianics and menu bar heights. 

Now It’s Your Turn 

I've tried to show' you some of the highlights of 
Appearance, but there's only so much you can convey in 
words. To get a belter feel for what it’s all about, check out 
the sample application. It has a lor of useful, real-world 
examples of using Appearance, especially dealing with dialogs 
and embedding. 

1 dunk you're going to love using the new routines and 
features that are now available. You’ll find you c,an get much 
more out of the Too1Ik:»x, which iriinslates into less code that you 
have to write and less time required to implement your interface. 
But wait, there’s more! Along with those benefits, you’ll be ready 
for switchable themes as well. Now go check out dial sample 
code and get cracking! K1 
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Cal Simone 


According to Script: 

An External Editing Apple Event Protocol 



Cal Simone 


In recent years, Macinrosli developers 
have lx?gun to move away froin hige, 
monolithic programs in favor 
of a more modular approach to software, 
producing leaner, more efficient 
applicutions thjtt don't try to do everything. 
An effective way to accomplish this Is 
thrmigh external editing, in which one 
application uses Apple events tt^ call upon 
another applic:iiUon for editing services, 
Kxternal editing allows your application to 
take advantage of editors im[)leniented as 
Apple event-based server applications, 
which I discussed in develop Issue 29 that 
can k‘ ftxind at<http://17,126,23JO/dev/tDC.shtml>. 

In this column, I’ll be exploring the 
advantages of implemenring exiernai 
editing and die basics of making it work, 
and ril also present a grjoil starting 
j^oint for a general external ediiing 
implemenLaLion. At this time, there is no 
generally applicable external editing 
suite that’s part of llie Apple Event 
Registry. Ilowever, there is a suite in 
fairly wide use that’s designed 
specifically for external editing of 
graphic objects in word processing 
documents (discussed later), and the 
more general external editing .siiite 
presented fiere is largely derived from it. 


Types of Apple Event Usage 
First let's look at the iyj>es of Apple event asage to see how 

external editing Hls in. In general, there aa^ iliree ways Apple 

events <::an be used: 

• Direct progrum-to-program cominumcation lietwecn two 
applications — One or Ixith applications have intimate 
knowledge of iJie other's Apple event proftKol. Either or Ixxll 
of the applicatifins can Ix! die client or the .server. This usage 
has largely faded fi'orn practice. 

• Service modules — A client application calls upon the 
services of another application as thougli that application 
were embedded in I he client. An example is tile relationship 
Ixrtween a word proces.sor and a spell checker. External 
editing falls in this category. 

• StTifiiing — ljf)ts of sc:riptable appiicaiioas aie lianging out, 
saying ‘Tin available'’ and “"lliis is w^hat 1 do." Tlie scripting 
language is ihe client, and it ckK^sn’L have to detennine which 
fxins of die Apple event protocol of the scriptable aptilic’ations 
are necess^iry to a>ntiol them; ihaf*s xlw .sc ripier’s tesponsibiiity, 

Advantagf-s of Exiernal EonTNCi 
There are sttveral advantages to implementing external editing: 

• Developers c^an effcciively extent! the capabilities of their 
ap[ilications by leveraging t>lT of apjiHcations from odier 
vendors, so it’s not nccessiiry to implemenl an editor For each 
data type snp[X>itc%! by your application. 

• Sint:e each developer has a smaller code ba.se to manage, 
applications will have fewer bugs. 


Cal Simone (mamevent@his.coiii) lias lieen fighting the gtxKl fight to lielp develojiers implement scripiabiliiy, cleanly and 
consLstendy, for nearly five years. He',s currently excited about external editing, and if you are, too, he invites you lo e-inatl him 
to continue this dtsciission. lie also encourages you to submit die dictionaries of your applications, parts, or scripting additions 
to feview@script.oig. 
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“ LLsen> cm pick :mcl chiKm: ilic conibinatlon of UxJs ilicy like 
from difFercni vendors, Ixmefltin^ from ilic advantages that ii 
stand-alone editor designetl for specialized usage can tiffer, while 
reuiining act'ess to all the feaiuix^s of fhe client application. 

* Users can use one environment for editing the same kind of 
data, regardless of which applirations they work in, enjoying 
a consistent experience. 

If the above sound familiar, iliat's Ixcause these same 
advantages are central lo OpenDoc's philosofyhy. In the non- 
OjxrriDtK: werld, you can acliieve much the same elTecf by 
implementing exLernal editing. 

Note tliai in tills discussion, client [iic-iins ihe application 
a'quesling the edit (not tlie actual user), and editor means llu‘ st^rver 
application. Any application iinplemeniing the Apple event object 
intxk^l and the Q>re suite ttm easily take advaniagt* cjf external 
editing as a c: I lent, since most of the; wtirk Is done by the server. 

An Fatntfijl History 

The work done in the Wort! Services Apple cvcni suite 
paved the way for a t'onsisteni services prottrol. How ever, the 
details of that suite are somewhat specific to spx'll-i hecking and 
similar service modules, where the client and server interact 
more imimately. A modified veivsitm of the KGO (Edit Grapliic‘ 
Object) protocol is Ixater suiter! to external editing’s needs. Tlie 
main difference Ix^tween EGO and the external editing protixol 
that I descrilK.' here is that external editing relies less on cListom 
Apple events and parameters than on existing events detlned in 
the Apple Event Registry, in particular the Core suite, and can 
therefore Ik^ c|uic:ker to implement. 

In ECK), llic US4T double<IicLs on an ohject in a client 
a[iplk:ation, a server a[iplicaiion apjXMis mih the objcci in an editing 
window, the u.ser edits the d>jcc1 and dismisses the window, and the 
edited version appears in pLice in die t lieni's window. E.GO w'as 
originally developed ,s<j that m:ithem;itiail ajuaLions in word 
pnxessing dtxiuiients could lx c.dited in a full-featured e(|uuiion 
editor lltiwever, it was designed for nioa.^ geiienil use as an external 
editing mechanism for graphics emixdded in text doniments. llie 
first shipj>ing implementation in 1991 was to link Expa.'ssioni.st 
to MkToaift WorL E<7iO and extended versions of HCX) have Ixen 
implemented in word pntx'essors, such as Wordlk.^rtm. Nisus, and 
Full Write, as well as fidier tyjxs of aj:)plic'ations. such Tliairist, 
SigmaPlot, and Chenyil). (See <http://www.welLcom/-bonadio/aba/ 
ego.htnil> lor more details on ECiO.) 

Although not a part of the Apple Event Registry, the external 
editing prouxol that 1 deserilx" here, and a version that includet! 
extensions ap[>licat)le let script editing, are based on EGO 
concepLs and were developed in 1993- lliese ideas were sliapetl 
in discussions Ixtween Allan Ikinadio, founder of Prescienc:e, 
Michael Rulxfiistein of GimbridgeSuft, Lee Buck of Software 
Designs Unlimited, and myself, and were reviewed by others. In 
I99i, a [Kmton of the scripting version was implemented in 
Fat'eSpan and Scripter to allow editing and deliugging of scripLs 
in a stand-alone scnfii editor. Currendy shipf)ing versioas of 
third-party sLanti-alone scrip! editors include siime form of the 
protocol, witli exten.sions or variatioas. 


Please* note that to make the exLernal editing protocol useful 
for as wide a range of data, clients, and ediinr.s as possible, I 
haven't included the parts of EGO or its variations that are 
specific tii editing panicular data types. Em going to concentrate 
here on genera I-aisc* scenarios Ltiid the Apple event protcxtjls — 
the opecitions that can fomi llu! basis for external editing, Tliis 
is not a complete treaiment of external editing by any means; in 
particular, l it mostly steer aw'ay from user inlcrface issues and 
clLscirssions of error handling, both of which are iinponant issues 
that need to lx* :iddres.sed in any complete external editing suite. 
The goal of this column is to setTe as a ralalyst to speed the 
cmaiion and adoption u( such a suite. 

To BP Modal or Non-Modal? 

The external editing proicxol was designed to allows Ixith 
modal and non-modal editing. In modal editing, the client 
application requests the services of the editor and w^aits for the 
user to finish editing. 'Ehe editor returns the edited item to the 
client, and the client resumes <jpenition. Ehis modal editing 
situation [>revents the user from working in the client application 
during the editing ses^sion. I highly discourage anyone from 
going this (user-unfriendly) rt>ulc. The freedom, ease, and 
elegance of non-mcKlal editing far outweigh any superficial 
advantages of iiKxial editing. Modal editing is not recommended 
anti won't lx* tiiscussed further hcRr. 

In tlie less rigid world of non-modil editing, tlie client 
application requests the services of the editor and allows the user 
to edit asynchronously. During the editing session, the client u.ses 
W'hatever version nf the object it has, either die original or an 
updated version. When ihe editing is done, the etliior replaces 
die object. As optional [>arts of the protcxol, the client t‘an 
request tlie return of the currently edited version at any time or 
cause the editing ses.sion to lx* abLmd(.)ned. 

What You Nlld to ix> 

If you ■ re already supporting the object nuxlel and the Core 
suite, all you need to do is write the cixle to send (for clienis) or 
handle (for editors) one new Ai>])le event, and optionally handle 
(for clients) or send (for editors) another new Apple event. If you 
don't support the object model, this is a good excise to get 
started; you just have to write the additional ccxie to siij>port 
three Core evenis lliat are used in the external editing prc3tocoL 
Neiw iet',s take a lcK>k at litjw all this can he uccomplislied. 

Initiating the edit 

'Ehe user requests an edit, through some aclit>n in the iLser 
interface of the client applic*ilion. T1i<* mechimism by whicli a u.ser 
initiates an editing session Is ncX sjxxified as p;ut of the pioiocoL Ytxi 
am decide whaEs appropriate for your aj^plication — possibilities 
include double-clicking (jxfriiajxi with a mcxiifier key held down) on 
an ol>ject in one of the client s windows, clicking a tool in a palette, 
or choosing a menu item or button to act on the eiment selection. 

The client application retfue.sis an editing session by semding 
an Edit A[3[)k: event to die editor application. The Edit event, 
summarized in Tal>le I, is similar to the Edit Graphic event in the 
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Table 1 - Edit Apple event and parameters 


Event 

Suite and event IDs 

Edit 

With 'edif 

Parameter 

Type 

Direct parameter 
(keyDirectObject) 

Object specifier (or data lo be 
edited) 

keyAENome ('pnam') 

String 

keyAERequestedType f rtyp^) 

Class type 

keyAEPosition (‘kpos’) 
or keyAEBounds ('pbnd') 

Point or bounding rectangle 

keyAE Notify When Done j'Noti') 

Boolean or reference 

keyAESendHeartbeat fBeat^) 

Boolean 

keyAEUnique fUniq'} 

Integer 

Reply parameter 

Type 

Direct parameter 

Object specifier 


Meaning 

Sent from tfie client to tlie editor to IniHote on editing &esstor>. 

Meaning 

The client's reference to the (tem to be edited; this is the only 
required poromelen 

The title for the editor s editing window. [This porameter is 
highly recommended.) 

The type of data the client wonts returned when the edit is 
the edit is done. 

The position or bounds for the editing window. 

The client wonts to be notified when the userterminotes ihe 
edit. If the value is Sooleon,notify the opplicotion that sent 
the event; ifo reference, notify the opplicotion m the reference. 

The editor should check periodically for the presence of the 
originol item. 

The unique ID of a specific editing session. 

Meaning 

The editor's reference to the newly created editing session. 


Mtscelluneaus Staritlard.s af the Apple h'xvul Kej;iKtF>\ 

Tile clirea parjiiieter aT ilw Hclii evctii is iin olijeL’i specifier, 
which is u reference to the iieni uj he edited. Til call ihLs the 
client's origtml Hem reference. You can use any fonn (jf object 
specifier that suits you, although it s impinani to create an object 
.specifier that will always refer to that s[X"cific object regardless of 
die Slate of the applic ation — fomiUniquell) fils hie l)ifl. Note that 
lioth formAbsolulel*osition and (brinNanie .sliould lie avnideil a.s 
oh\LXl specifiers in this case, Ix^cause references by index can 
change as ireins are rearranged while the c<!it is txrurring. and 
names may not Ik* unique and am he changed at any time. 

It's also a gtxKi idea to inckide a name parameter (using the 
keyAEName keyword), whicli is a text string that ilie editor can 
use as the title for the editing window. Usually this is the name 
of the item tliat’s Ixdng editeti. althnugh you can make it 
something elsc\ if apprupriaie. 

fhe client can include an optirmal return type parameter 
(using I he keyAERequested i ype keywtml) U> sjxxify ilie iy[)e 
for the updated data vvhen it’s sent back to ilie client after 
editing. In addition, hie client might want an editing window' to 
be positioned ai hie s;ime place on the screen as the original 
item a|)pears in the client's window. To do this, the t Iieni can 
include an optional parameter (using \hv. keyAEPtJsition f>r 
keyAHHtHinds keyword) indicating the fH)silion or IxHinds that 
the editor can use to determine the locution for the ediiing 
window'. The value of this parameter could lie the dienl's global 
screen ctK>rdinaies of hie visible object. 


finally, its a gtKxI idea to include a session ID parameter 
(using the keyAEUnique keyword, with the ID 'Unief), TTie ses.sion 
ID parameter value is a long integer of She client's choosing, such 
as TVkQ>uni, that tmkjuely kleniifies the ediiing session. 

If the anenipt to send tlie Edit event results iii the error 
procNoiFound, the editor isn't running. If this happens, the diem 
should launch the editor and send the Apple event again. 

Tile editor receives llie client's ret|iiesl lor an editing session 
and hanilles the Edit event, auising the following actions to (xictm 

1. Tile editor exiracTs the tniginal item reference from the 
direct parameter (and the .session 11) parameter value, if 
the client included it) and keeps this v^alue with the data 
for the editing session. 

2. In the direct parameter of the reply Apple event, the editor 
places a new of>jeei s|X-eifier, which i,s a reference lo the 
ediiing sL^ssion. I'll call this tlie ediiing .sc'ssit>n reference. The 
editor then returns from 1 Kindling the F.iJii event, 

3. T he editor retjuests the item be ediiecl from the client by 
.Sisiding hie client a Get Data Apple event, passing hie dient's 
original item reference as the direct panimeler. 

4. T he dient res[K>nds to tlie (ret Data event by resolving the 
original item reference in tlie direct parameter (which the 
dient itself originally generated), in.serting tlie data for the 
item to lx* edited in the direti paratneler of tlie reply, and 
returning from handling the Gei Data event. 

The editor extracts the iienTs data from the reply to hie 
Gel Data event, opens an ediiing w-indow, and places this 
data in the window. 
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6. The* cdiU)r is l^naighl lo the Foreground, ready tn edit the 
data. If the client launched the editor and requested that it iie 
brought to the Foreground, this will hapi>en automatically; 
otherwise tlie editor can bring itself to the Foreground. (How 
to do this is discussed in my last column, and as I said there, 
this is just al^Hil the only situation where it’s reasonable for 
a server applicaiitm to Force itself into the Foreground without 
asking the user to switch appUcatkms.) 

Finally. Ixjlh applications txliim to their main event kKips, 
with the editor nf>w' in frt)nt. The appropriate suspend/resumc 
and activate events are delivered by the system luxI handled by 
botli apfilicalions as expected 

Early versions of the Apple Event Manager imposed a 64K limit 
on the size of data in an Apple event, including the attributes and 
any parameter data Your application should be prepared to deaf 
properly with this. The limit is not an issue if AppleScript 1.1 is 
running, and the limit has been completely n^oved in MacOS 7.6. 

Performing the edit 

The user tJcrfornis the desired edits in the editor application. 
In this non-iiKxial situation, die user can switch to other 
programs, incliidiog the client application, while editing. Tfie 
user can even iniliatc an editing .session for a ditTerenr item From 
the same client — the original item relorenecs and the editing 
i^tsskm references keep things slniighi. 

Genera[ly speaking, while the luser is editing an item in the 
editor, the client should not alkw any action that would cau.se 
that item to be modified. If the user again requests an edit of the 
same item, ihe clieni shoukl .send an Fdit event that Ls identical 
to the original edit request, witli the same t)i>jet i sptjdher and 
sc-ssion l[> parameter. Under nonnal circunistance.s the editor 
.sliould not iniliate another editing .session for that item. 'Hie 
currecl lx*havior is for die editor to activate the ecliitng window' 
corresponding to the original item. 

Terimiiatiiig tlie edit (from the editor) 

Ihe LLser finishes editing by closing the editing window^ in tlie 
editor applicaiion. If there Ls changed data, then Ixforc the 
window is actually dLsinis.sed tlie editor shoukl display an alen, 
asking tlie Liser to confirm that the changes sliould lx sent back 
to the client. If ihe user so confirms, the editor creates and sends 
a Set Data Apfile event Us the client applieaiion, p^issing the client’s 
original item reference in the direct |>anmietLTt and tlie ujxlated 
iiem data in the (bira parameter (using the keyAEData keyw'ord). 
If the clieni included a session ID parameter wnth the original cxlit 
request, this jiarameter Is also inciuded in die Set Data evenL 

The client application responds by rest>lving die original item 
a'ference and extracting the upckited data from the data parameter. 
Ihe client can replace tlie original item with the updated data or 
otherwise use the ckita in whatever manner it sees fit, such as 
iipckiUng a datalya.se or brfiadcasting the change lo other 
applications. Tlie prc‘sence of the session ID parameter tells ihe 
client that this Set Data event is associated w itli the editing session, 


as opfKxsed to any other Set Data event that might cli;inge the data 
for the original item. After the clieni returns from handling the Set 
Data event, the editor may safely di-smis-s ihe etliiing window. 

If appropriate* the client could now Ix’ brought to tlie 
foregroiinri. At this point txilh applic^uions have again returned 
to their resfxxtive main event loops, and the user may continue 
working, using the new^ version of the edited item, 1Tie u.ser has 
had a smcxith editing exixrience and is happy. 

ExlTiND Yi)LlU OfIIONS 

In atklilion to the basic process described above, there 
are several optioas Uuit may be implemented by rather the 
client or the editor. Implementing these options requires only 
that you sencl no more than three additional Core Apple 
events (iwo of which are Apple events you musi handle 
anyway) and handle one new^ Apple event* 

Working with interim versions of the edii. During the 
editing scssitm, the user may w'ani lo uy' out versions of the 
edited item without terminating the editing session. Here’s one 
way to accommodate this: 

1. Tlic user requests an interim version Ik* sent to the client 
application (by chcx>sing a Send Back comiiumd like iluii in 
Stripter, for example, or perhaps by chtX)Sing Save). 

2. The editor crcales a Sel Data Apple event coniaining ihc 
current version of the edited item’s data, the same as it 
does w'hcin terminating the edit, and sends the Apple event 
to the client afjplicalion* 

3. The client application extracts the ufidaled data from the 
Apple event. 

4. Tlie user tries out the updated version of the item. 

In general, the client application will know wlien an 
upckited version of the item is received vki a Sel Daui event by 
the pre.scnce of the session ID panimeter, but it may not know* 
when the editing session is completely finished. If the client dtxs 
need to knf>w w^heo the edit is I’inished, in order to stop keeping 
track of whether the item has an outstanding editing .session, the 
client can request that the editor notify the client when the 
editing session is finally done. The editing completion 
noiificaLion rc<]uesi is made w'hen the clieni first iniiiaies the 
external editing prexess (more on this below). 

Calling the edit back (terminating the edit from the client) 

If the client application allow^s it. a user may (while in the 
middle of editing) delete or copy the original item in the client 
applkiilion, dose the windf>w containing the original item, nr quit 
the client application. In any of these situations, the diem 
application may need to obtain the cunemly edited version of the 
item and/or terminate the editing session, hssenfially, the data in 
any outstanding editing scs.sion is an extension of the c:licnL*s 
application or document chtta at Luge and must lx called back for 
any reason that recfuires the current value of the itenVs data. 

Note lliaL llie act of dosing the server’s window' is not rerfuired, 
I ml it Is higldy recommendeci. Leaving tlie editing window o]>en 
eremites a situation where later dosing the window' and conhnning 
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the cliangcs coukl result in prohlcaus, llie alitor mighi unemfM to 
send a Set Data Apple event to an application tliat’s no longer 
Rinning, or with an objea reference tbit's no longer valid. Even 
worse, the oijjcci refenener mighl l)e valid, l^ur now refers to a 
different object {defsending on the nature of the object Sfxrcilier). 

To call an edit back and terminate the edit: 

1. The cjicni tenninaics ihe editor's ediiing session by sending 
the editor a Close Apple event, widi the editing session’s 
reference In the direct parameter and an optional 
kAESaveOpiions parameter The value of kAKSaveOprions 
determines whetlier the updated data is called back to tlie 
client; the default value is kAHAsk. 

2. The edilt)!' rc‘c:eives the Close event, exiracls an<l resolves the 
editing session inference, and extracts the keyAESaveOptions 
parameter, if present. If the value of keyAESaveOptions is 
kAENo (sent when tlie client isn’t inieresied in the uptlated 
data), the editor reaivns noFar as the result of its event handler, 
closes the window, di.sc'ards the data, and skips tlie remaining 
steps. If the value is kAEYes, the editor proceeds to .step 4. 

3. If the editor finds a keyAESaveOptions parameter with a value 
of kAEAsk, it displays an alert conhmiing that changes should 
\yc seni back to the client. If ihe u.ser dicks Cancel, the editor 
returns userCanceledEiT as the result of handling the Close 
event, the client abandons the current operation, and the 
remaining steps are skipped. If the user clicks Ik^n’r Send, the 
editor discards the edited data, closes the editing wandow* 
and returns noErr as the result of handling the Cdo.se event, 
and the remaining steps are skipptxl 

4. The editor creates a Set Data event conlaining the eurrent 
version of the item's data and sends this event to the dient. 
Hie diem mti.st implement idle and filter pines to handle the 
incoming Set Data event w hile ihe Close event is ouLsUinding, 
otherwise this will result in an Apple event deadlock. 


5. Hie dlenr checks the result of sending the Close event. If the 
result is userCaneeledEir, tile client cannot quir or close die 
window ct:)ntaining the original item. 

6. The editor discards the etliretl data and closes the window. 

Reverting to a previous version (by tlie editor) 

While w^orking in the editor, the user may want lo reven to a 
previous version cT die edited item. If the user chcxises Revert 
from the editors File menu, the editor should display a standard 
‘"Revert to last version?” aleri, then replace the altered version with 
die origimd version fmni die client. To revert to tlie client’s version: 

1, llie editcjr requests the previous version of the edited item by 
sending a Get Data Apple event to the client, witli the original 
ileiTi reference in the direct parameter, 

2, Tlie client replies w'ith its current version of the item’s data in 
the direct parameter of tlie reply to the Gel Data event. 

3, Tlie editor extracLs the eaifier verskin from the direct 
parameter of the reply and displays it in the editing window, 
in place of the edited version. The user may now continue 
with die editing session. 

Checking the status of an edit (by the client) 

If tlie clieni wants to know whether the editing session Ls stEl 
in progress, it cun send a Does Ohjeci: Exist Apple event to the 
eclitor, with the editing ,se,ssion reference in the direct pai'ameter. 
If the reply contains a boolean value of False or if you get a 
]ii(xNQtFound eiTor, it's no longer a good idea for the client to 
send a Close or Get Data event for the editing .session; the client 
c:an condiide thiU the ediiing .sessitin has been abandoned or die 
editor has crashed. The client can deal with the ixissibility of not 
receiving a completed edit by notifying the user with an alert 
explaining that the editing session may have been abandoned. 


Table 2, Editing h Done Apple event and parameters 


Event 

Editing h Done 


Suite and event IDs Meaning 

’edit\ ’done' Sent by the editor to the client when the editing session is finished, (f 

notification was requested by the client, 


Parameter 

Direct parameter 
keyAEUnique ('Untq') 


Type 

Object specifier 
Integer 


Meoning 

The editor's reference to the editing session. 

The unique ID of the specific editing session (required if the client included 
this parameter In the original edit request). 


Reply parameter Type 


Meaning 

No reply from the client. 
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Checking the status of an edit (by the editor) 

Sometimes it can be helpful for the editor to know whether 
the client Is able u> receive the resuius of a compieted edit. The 
editor can clieck just before it sends back the LE|xlaied data for 
the item by sending a Does Object Exist Apple event to the client 
application, willi the client’s original item reference in the direct 
parameter. If the editor doesn’t successfully receive a rep^y (tir 
receives a reply with a Boolean value of false) to the l>c:)e.s Object 
Exist event, the editor £:an assume that conditions in the client 
application for receiving ufxlaied item data arc iinfavomblc and 
that it should not attempt to send back updated versions of the 
item. The editor can notify the usc^r by putting up an alert, asking 
if the edited version should t^e saved to a file or abandoned. 

To determine whether an editing se.ssion is still valid, the 
editor can chec:k perfodicaily for the existence of the client’s 
original item on wfiich the edit is !>ased. One way to do this is 
with a heartbeat, which is reque.sted by the client when the 
edit is initiated by induding the optional heartbeat parameter 
(using a keyAESendHeartbeat kc^yword, willi the ID 'Bear') in 
the Edit Apple event. 

Notification of editing completion 

If an original item still has outstanding edits, it may not be 
safe to c:lose the window, delete the item, or ejuit the client 
application. A client application lliafs keeping track of 
outstanding edits can optionally request that the editor notify it 
when the editing session is finished. 

The client requests notification of aliting completion when tfic 
edit is initiited, by including the optional notify parameter (using a 
keyAENotifyWhenDone keyword, with the ID 'notf) in the Fdit 
Apple event. Tlien, when llie user doses the window or (juiis the 
editor, and after tlie final Set Data event, if any, has been sent to the 
client, the editor will send an Editing Is Done Apple event (nec^e^ry 
even if no dianges were made in the editing session). Tlie Editing Ls 
Done event is summarized in Table 2. Tlie client responds to tliis 
e\ent by noting internally that the editing .session Ls ranpleCed. 

Sending the original data to be edited in tlie edit request 

Ihere are situations where there's no object to be edited in 
the client application, such as when ihu client wants to re<iuest 
editing for data tliat’s in a file on disk. In sraEations where the client 
isn’t directly concerned witli die editing session, it can send an 
Open Apple event to ilie editor with a file reference or alias to ihe 
file to be edited in the direct [larameten Tliis is proper when tiie 
cLata to be edited isn't embedded in a client’s document or 
application data, and the client isn’t responsible for storing the 
ufxlated data; the editor takes care of ihls. 

On the other hand, when parts of a document are stored in 
.separate files, as with a page layout application, it's betrer that 
file client use die noniial methods oudined above, creating Edit 
Apple events and object specifiers. While it is possible to send 
the acRial data for the item to lie edited in the direct parameter 
of die Edit Apple event, I generally don’t rccoimnend diLs 
approach. The solution is to support the object model; in dtis day 
and age, this is simply the best way. 


Be a Pioneer 

Obviously, every aspect of the client/editor relationship 
hasn’t been explored here. As you iransfomi your a|>plication into 
a client or editor, you 11 run into user interface issues that need to 
be worked out, and you1I need to implement appropriate and 
rol>usi error handling. But right now, watli just a few bits of code, 
you can begin to implement the external editing protocol as either 
a diem or an editor and try it out. If you don’t yet support the 
object model, this is your drance to get witli die piogram. 

Talk to other developers whose applications you want to 
work with, and get the discussion going. A g(x>d place to stan 
is the appiescripEimplemeniors mailing iLsl (to join, ,see 
<http://vwvw.sol utions.apple.com/ListAdm With a little luck, and 
a little wwkj well soon have a complete specification that 
works for most everyone. U.sers will thank us for it, as they 11 
be able to experience the richness of using our applications in 
a variety of new situations. 


1 hanks m Andy Bacbot^'ki, Allan Bona^Iio, and Jon Fitgh 
for reviewing this column. Allan gerieroiisiy donated the use 
of the HGO concepls, and Michael liahenslein insiskmlly 
convinced the author to look at EGO. Lee Buck worked unth 
the author to siniplify the events, fil 
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by Mike Fullerton 


Squashing Memory Leaks With TidyHeap 


One of the more mundane aspects of 
c^ication deiielolnneni is making sure any 
system resources that applicaium 

aUocates get dealkxjated, {x^tfUculariy memoj^' 
aliijcatiom, Jfmik of the hours you 'vg ipenl 
tracking down pesfy numiory} leaks. A 
Ixmerfiti debugging ami QA txxil, TidyHectp 
watches oar memon^ alkraitMm ami helps 
Mike Fulterton Mrfe. Umrn how to 

make sure that metnoryf allocated hy ynnir 
aipiiccHion is ahmys mmaged correctly. 

I idyl leap is a tcxil for tnicking and 
ve^rifying dynamkally aII(seated JMemory in 
C++ appliaiiioRs. Ii siarieci out as a qukk 
and dirty way to keep track of undeleted 
objects in the MacApp framework and 
evolved into a tool for anyone writing 
application software in C++. TidyHeap 
works with any application built in C++, 
with or without a Intinework. Among its 
powerful features are the following: 

* if your application allocates an ol>ject or 
(.lata thafs never deleted, TidyHeap tells 
you about it when your application 
quits, (Objects and tiara alkx'ated l:y 
your ap()licautm are allied cUtml tfhjecis 
in this article.) 

• TidyHeap can provide you with the 
filenatne and line nuftil)er where^ any 
existing client tjhject w'as createck indLiding 
a client objed that’s never deleted. 


• You c^aii tcli TidyHeap to watch for double deletions on aU client 
objects or on a specific client object. 

• You am verify the integrity of a single dient object or all client 
objecLs at each pass through tlic event ltx>f>. 

• Yt>u cdn have Tidylleai^ break into MacsBug when a specific 
client object is deleted, 

• You can force every single new operation to fail in consecutive 
order, in consecutive nms of your application. 

• You am design your own te.Hls for specific client objects or for 
all client objects. 

In shoit, Tidyhleap is designed to be flexible, pow^erful, and 
u.ser extensible. Currently, fidyHeap runs only on the 
PowerPC^'^ platform (if you would like to see it implemented for 
680x0 machines, send e-tnail to mabugs@devtools.app!e,com), and 
ids compatible only with Metro werks Code Warrior (we 
MacAppsters plan to make it compatible wath the various MPW 
compilers sometime soon). A t)ackage of TidyHeap tnaterials is 
available at <http://www.inactech.eom>. 

TidyTIcap Basics 

TidyHeap itself is a small lihmiy of C++ classes that inteirept 
and tnick all allcK'ations and deallocations i^erfcxmed by the glolral 
<j|xraiors new and delete, li ckx.‘s this invisiirly — you don't need 
to do anytliing but oil new and delete in the way you usually do. 
Also, sinc'e TidyHeap is essentially a debugging tfx>l, it's compiled 
and enal>led only if iLs j)re(>r(xe.ssor constant qTidyHeat) is 
defined to tnie. Hits enables you to turn it off easily when building 
nondebug versions of your application, 

TidyHeaf^ wex ks with any data tyjx^ that can Ix^ created with 
new. This can Ix^ all ilie objects in your application or framework, 
structs created to be pa.ssed to Ibolbox routines, or huge char 
airays cirated as bullei^. it really doc.sn'i matier. TidyHea[) treats 
ail alkKiilioiis us raw lilocks of allcx'ared inemoiy, witliout 
knowing or airing w^hat the user data is. 


EVfikc Fullerton (juiker^afjplexnm) Ix^gan his hij^h-tech training wiien knee-high tu a prognnnnier hy designing and buikling 
vast dvilb^itions out of Legexs, masking uipc, and ruhIxT hands. lidicving that axnpuicrs .siiould lx as mudi Fun, he Ixg-an 
progTammiiig in the entertainment industry. He was lead programmer for the .strategy game Allied General, and then for the 
Macintosh versirm of Pan/.er General. Wlrile leading the develupiTieni of a cross-platfonTi C++ Frainew^ork on which the games 
were buiic he decided lhal nuiking scjftw^are Wics a pain in liie brain, and he set out on a quest lo make it aisier. Now ai Apple in 
the Framework.^ group, his grail is making MacApp iasiinely great, and he\s currently up to hLs eyeballs in providing it with 
networking support. 
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The raw materials 

7'klyHrap ships wiih iwo QjcluWarricjr projects and eveiy 
st)urce file needed to hiiild and use it. 'Hie prtjjects are For 
building the shared library, l idyHeapSharedlib, and ihe siatie 
library, TklyHeapPPC_<L Hoih lifmiries anj required Ix'ouse 
TidyHL‘a|xSluiredLib dtx^sn't contain lidylleap itself, but is the 
meclianism 1 use to make sure that TidyHeap is the last Lliing to 
be deleted, after static ck^simction lime. 

It's essential that TidyHeap be the very last thing deleted 
when the client application quits. This guarantees that the 
application won't try to delete anything after TidyHeap, which 
could cause Tidyhteap to return inaccurate information. To 
make sure that it terminates after static destruction time. 
TidyHeap registers a callback in TidyHeapSharedLib that's 
called when the shared library terminates. It so happens that 
this occurs after static destruction time, which ensures that 
TidyHeap is the very last thmg deleted 

YtHi niiiy build the ,s| jarud library if you need to; however, a 
built versajn of Tidyl leapShaiedLib is also included, lastall thts as 
you would any shared libniry^ either in the s;imc tdklcr as Llic 
applk“ition or in your Rxtcn.sions folder — just lx: oieful not to 
insuill it in ix>ili jrlaccs. Also, don’t fojget to add 'rkiyl leaiiSharedlib 
to your application's project! At this time we;ik importing <jf the 
shared libraiy is not suppf>m‘d, so don’t use weak litiking. If you do, 
your application may crash. 

The second Code Warrior project is for TidyHeap iiselb 
'('here are abrxu 35 source files. You can include them directly 
in your applicalion’s project or you can build them into a static 
library with the TidyHeapPPC_d.7i project and include the 
static lilirary in your project. The cluace yours, IVi'sonally, [ 
prefer building TidyHeap as a library. 

Finally, Tidylltrap ships with two small uhjIs — New 
Dropjx^r and TidyHeitp Uirector. New Dropjxr allows yt>u to 
easily insert into or reriKJVe front your source files an imj^ortani 
macro, and TidyHeap Director lets you change TidyHeap’s 
Ixdiavior without recompiling your ctKle, Tliese Uxtls aren't yet 
fully .suppt>rted by Apple tso use tliem at your own risk), but 
tileyhe very useful — as you'll see later. 

Hooking ill your tminework or project 

ikxtking into Tldyllea]) Ls simple. You deline a C function nanuxl 
.TidyHeap deciaa's and calls the hinciion hut dtx-sn'i (k:fine it. 

(If This fund ion isn’t defined, you'll get a link errorj defines 
ilic global ofXTcilors new and delete that TidyHeap aills, and 
alkxrates AC_CTidyHeap or a client-defined snlxTi.ss of TidyHeap. 
(See “MacApp Naming Ctianges" for the reasons beliind 
TidyHeap’s naming conventionsJ 

TidyHeap has static pointers to the global operators new 
and delete. By defaiillj The static pointers point to NewPtr and 
Di.sp<isertr, These are tlie functions that TidyHeap calls to 
actually create and delete memory^ bkx'ks. the function mirsi .set 
the proper memory a I kx at ion and dealloeatkm functions for 
your framework liefore it crcntle.s AC_CTidyneap or its subclass. 


For example, the lollowang cixle defines for the MacApp 
framework in whicli MAOjxraLorNew^ and MAOjxtatorDeleic 
are MacApp memory allocation and deallocation hooks. 
(Allhough this and later examples use MacApp, don't forget that 
TidyHeap works with any frameworks 

AC^CTldyHeap* CreiitcTldyHc'ap {} 

I 

AC. GTidyHeap: lOiobalNew ^ HAOpifraLocNL'wi 
AC CTidyHeap:"GlobalDeiete ” HAOperatorUfeleLo: 
rptiirn TH new TMaeAppTidyHeapO : 

I 

The AC_CTiclyHcap class includes viiHial functams tliat you 
can override if you w ant to change Tidy Heaps behavior. For 
example, the method Handk^NilAlliKaiion is called by Tidyfieap 
W'hen it forces new^ u> fail. If your framework throw's an 
exception wdien new fails, you can override HandkrNilAlkx:alion 
to throw the same ext:epiion. This enal>lexS TidyHcaj) Iti proixniy 
emulate what fiappcns wlien new fails in your envifonment. 
(More on forcing oew^ to fail later,) 

hb use the defauli TidyHea(i and the tlefaull memoiy 
alltHalion hooks, include the file Createl>efauli ridyHeap_AC.cp, 
which defines a function that u.ses the defaults: 

AC CTidyHeap' CreateTidyHeap£) 

r 

rctiirn new AC CTidyHeap: 

1 

Nt>w youte a:ady U> use* Tidyf leap and begin reducing those 
hours s|xnt tracking memor>' leaks. 

First eontaet 

In this section you'll meet the headers and traikrrs, the 
ACJTriclyHeapBkxk object, and iht* TH_new^ niucTo, all of which 
TidyHeap uses to track and stoa* data it tieeds to watch over your 
memory alltKrations and perform various anions. 

fidylleap itself is a single object that’s created when the 
gk^bal opt^ralfir new- or the AC^CTidyHeap static memlxr 
function Instance is called for the first time* Instance mturns a 
pointer la the AC_Cl'idyHeap objecl. If this ol jjcci husn'i lx*en 
alkR'ared yet, lasiance creates it and returns the pointer. In this 
way you're guaranteed to have a valid pointer to the 
AC_CTidyneap object. You can use Instance to call 
AC_CridyHeap's interface. For example, tl;e folkwing line of 
code relums the total amount of memory currently allocated by 
your application using the new' operator 

long sizeTally = AC_CTldyHeap: * InsttiJice() ^Ct’lSiiseTally t) j 

Header and trailers 

When your a()plication culls new to allcx’ute a client object, 
TidyI Iea[> intercepts the call and incresises tlx* amount of memory 
alUxated by a small amount in onler to put a I leader and trailer 
artnind the client objeefs memor)' l’>kx'k, 'HdyHeap stores dita in 
tlie lieadcr and trailer that allows it to trick your Hicni objat. The 
header contains a j-xunter to;m AC'JTidyHeafilikxk object, which 
has fxx-n alkxatcd by TidyHeap and stoted in a linked list, tills is 
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how TiciyUcMp tnicks all ilii? clit-ni objcTis. EvL-ry client ohjeci 
alltJcalcd witli new has its own AC_Clklyl leaf^Block object 
(clescnlied in tlie next section). 

The header and trailer also contain tliree luarkcrs. Markers 
are lon^ integers tlial Tidyhleap sets ro magic values you can 
easily recognize wlieii kx)king at a raw memor\^ tlump of your 
ol)ject — OxFlFlFIM, 0xi*2K2r2r2, and OxF3F3F3F3. Tliese 
markers act 21 s fences around your client object (TidyHeap 
operates on tlie assumption tlial if the markers get inished your 
client object is probably trashed also). TidyHeap can c|uickly 
verify tile integriiy of your bl(x:k of datti by checking tlie markers, 
there are two markers in the header, one just liefore and one just 
after the pointer to the client object's AC_CTidyHcapBkx k object, 
and one marker in the iniiler, its shown in Figure 1. 

AC_CTidyHeapBl<K'k and block IDs 

The AC_CTidyHe 2 ipBlock class is imptirtant. An 
AC_CTidyIletipBlock object holds inlbrmatiim aboiit the 
client object your application allocated, anti member 
functions defined for the class are used to perform various 
operations on the client olijcci. 

Your client object s block IP is one ol die more iistTuI pieces 
of inhirmation you can tihlain from AC_CTkly Heap Block. TTie 
bI(KkID i.s a unique nuinlKT assigned by Tidy! ieap to eacli client 
object that's created with new. 'flie block 11) Cfirresponds lo the 


MACAPP NAMING CHANGES 

The MacApp team is working to make MacApp a 
less monolithic framework. Whenever practical and 
possible, weTe designing and implementing MacApp's 
new features so that they can be used independently 
of MacApp. TidyHeap is a prime example of this trend. 
Other features in development are networking 
support, cooperative and multiprocessing threading 
support, OpenDoc container support (ALOE, the Apple 
Library for Object Embedding), and such useful things 
as enhanced Standard Template Library (STL) support 
and a handful of C++ design patterns (useful 
abstractions for common problems). We're calling this 
collection of features "Apple Classes," but that may 
not be the final name. 

We want everyone to be able to use Apple Classes 
without running into namespace and file inclusion 
collisions, so after much heated debate, we decided to 
adopt and adapt the OpenDoc Development Framework 
(ODF) naming convention until we get universal support 
for C++ namespaces in all our compilers. That's why all 
the TidyHeap classes are named AC_CCIassName. The 
"AC" stands for "Apple Classes" and represents the 
scope of the class (ODF begins names with "FW" for 


miniixT of times new has lx;en atlleil, so if the block (D is 6, the 
client object was created on the sixtii call to new. Here's an 
exaiiiple of how to jfcl I he block ID from a client object; 

TClleiftObject^ myObjecL ” new TCliervtObJect; 

AC CTIdyHffUpBlock* objiiloerk - AC_CTidyHeapi:lnstance(}- 
>GetBtod^ (myObjeciJ; 

Una Ulockid = objBloi:k->GetIDO: 

Among the niemlier functions defined for the 
AC_CTidyHeiipBkx.'k class is rhe Verify meiliocl By first getting 
the pointer to its AC_CTidy Heap Block objet I and then calling 
AC_CTidyHeapBlock::Verifyt you can verify the integrity of yf>ur 
client object. The Verify method cross-references the pointer to 
rhe client objecFs AC_CrkiyHcapBkx:k object that the client 
olijeci stores in its header with the pointer to its diem object chat 
the AC_CridyHe 2 ipBkK'k object stores. It also checks the validity 
of the blcKk’s markers. For example, if you write pa.sr the end of 
your object, the trailer marker will be invaliti and TidyHeap will 
notify you l>y returnitig an error from Verify. Here's an example 
of using the Verify inelliod: 

TClientOb ject * aiyUb ji^ct - new TCHoatObject: 

AC CTldyHeapBlock* (ihJBlock “ AC_CTidytfeap::lnstance()‘' 

>nfit EtI(jrk (inyDbjcf 13 \ 

AC_CTidyHcapF*rrui -jit “ objBiock'>Verify(); 

storing fileiiaiuc and tine number with TH_new 

TidyHeap provides n!_iit‘w, an optional macro replacement 
for I he global operator new. Tl I new stores the lilenanie and line 


"Framework"). The underscore conceptually represents 
the C++ scope operator (For example, 
AC_CTidyHeap will become AppleCiasses::CTidyHeap 
when C++ namespaces are supported.) The second "C" 
in "AC_C" represents the usage of the class — "C" for 
classes, "M" for mixin classes, and "S" for structs. 

Filenames in Apple Classes significantly diverge from 
the ODF naming convention. ODF is cross-platform 
(Windows and Macintosh), so all its files conform to the 
Windows 8-character maximum. Because we don't need 
to do this, we decided to make the filename the same 
as the class name with a slight twist, which is that we 
append "_AC" to the class name like this: 
CTidyHeap_AC.h. We put the difficult-to-type 
underscore at the end to make life easier in dealing with 
the files in the Finder and for situations where you 
would want to use type-ahead, such as in a 
CodeWarrior project window. 

If the TidyHeap classes accompanying this article 
begin with letters other than "AC," it's because a 
different name for the collection of features referred 
to here as Apple Classes was adopted after this 
article was published. 



102 


SqI ASHING MKMQKV liiAKS WiTlI Tin^ f lLAP 


IN MacTech.Magaztne • May 1997 








I 


Heoder - 


Troiler 





Figure L CHerU object memory hkKk 


numl)cr of where the client ol:»ject was created in the client object's 
AC_CTidyIleapBlock object. The filename and line number enai^le 
you to find the ctKle that creatc^d undeleled client olijecls, T1 Lnew 

uses ihe C++ prc‘processor’s buili-in _IILH_ and _LINK 

macros, which is why Tl l_new needed to be a macro. Of course, 
you don't want to ship your application with TidyHeap enabled, 
so TH_new resolves to new when qTidylleap is not defined or Ls 
defined to false, making it possible to leave the TH_new macro in 
your shipping code. 

listing 1 shows [low uj gel a filename and line number for an 
object created witli Tll^new, When the prognim is run, you get the 
follow'ing output: 

MyObject was created in file: Haia-cp at line #1 

Tlie New Dropper tool that ships with TidyHeap makes it 
easy to switch berwt:en new and TH_ncw. Drag your project's 
folder onto iJie New Drtipper HK>1 and you're presented with m-o 
options; change ‘Ill^new to new or change new to TH_new, 
Ihat's it. When ytai make a choice, New Drop^XT scans die source 
files you dropjKd on it and makes the chasen change. New' 
Drop[X.*r finds all tile source files in all the folders, no matter how 
deeply you've nested them. !t only iipens files that it decides are 
text files with simrve etde in Uiein, In other words, it won't open 
your project files, or even a text file that doesn't have a “.ir or 
".cp" appended to its name. It doesn't change new in comments, 
in object-specific overrides of llie new operator in a client object, 
or if file file has 'lldyUeap'' anywhere in its name. The software is 
provided as is, so please make a backup of your st>urcc Itefore 
using it! 


Warnings, lagging, and the log file 

TidyHeap has two types of tiK'ssages — a logged mes^sage 
and a warning — and provides a default mechanism for directing 


logged messages to a log file. Tlie log file is written to die s;ime 
folder as your application and is named myapplication.log. Its an 
MPW text file and is compatible' with MhW scripting. The 
AC_CridyHcai> mefiiod you cun use to log a string Ls 

AC_CTidyHpflp::Logf(conat char', .■.): 

All Lite tjuifiul frtwti U)gr is apjxtidetl to the log file, and it's 
designed to be compatilile with the AN SI-same bird printf, Here's 
some code showing how' you could ifse I/)gf: 

TCiientObject* niyObject = TlUi(^w TCIIpntOhjRct: 
AC_CTidyHeapBj.tick* objBlock = AC^CTidyllciJp: ilinuariccO 
>G^tBlock(myObject): 

AC_CTldyH«ap::Instance()-)logf("The object 1 just created has 
an TD of %ld% 

objKlock >GRtrn{)) ; 


'Hie warning mechanism is simjily a wrap|ier on top of 
DehugStr Lliat can be turned on and ofT Voull get a TidyHeap 
warning in only a few situations — in general, to notify you that 
something ha.s gone wTong. For example, if your application 
lemiinales and there are five client objects that haven't been 
deleted, you1I get the w'arntng "'TidyHeap Warning: You fiave 5 
undeleted blfxk.sl' 

This yndeleted-block warning has a g appended to it so 
that your application will continue immediately after dropping 
into MacsBug. ! think you1l like it better than typing g and 
Return a thousand times. 

TIr: AC_CridyHc’ay> nicilicxl tliat you use to send a warning is 

AC_CTldyR 043 p: iWarnf Cconfst char*, 

like Tx)gf, it Ixhavus die same way as file ANSI piintf, exc'ept 
tlxit file output gpes to MaesHug, of a>urse. 

When you get a warning, TitlyHcap usually logs more 
information aljoui the problem to tiie log file, which is descrilsed 
next. 

Using the lag file 

Let's see how to use the log file to track down memory leaks. 
For example, after airming the program in lasting 2, you'll get tills 
warning from TidyHeap: “TidyHeaf) Warning: You have 2 


Lislmg L Getting thefiiename ami line number 


void EtaiiiD 
I 

TCllentObject“ myObject - TH_n€w TCiientUbject; 
AC.CTidyHftapBlock* objBlock - 

AC_CTi cJyHeap: ilnatfloceO - >GetBlack (ayObject): 
const chat* filoNnmerir - objBlock->GetFileNaffleD: 
long litieNum = objBlock >GotLLneHumD ; 
prinif('’MyObject was created in CHe: %n at line 
tfxidVn", 

fileNamePtrH lineNum)i 

I 
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undeleted blcK’ks," When there are undeleted client objects after 
your appftcati()n quits, I'idyHeap logs infomialion about all tlie 
objects that haven‘t Ixx-n deleted to the log file. 

Here's what the log file looks like after you ntn the 
program in l.isting 2: 

/ilM TidyHcap Ti^rminatioii 

## 2 Outstanding blocks. 3 total blocks* Ave Size 4*5QOOQ{3 

New called 3 times, Delete called 1 tiraes 
#« aiocklnfo: ID:1. Address:03clECSF8C, Sizei4 
File 'Kain.cp'j Line 6 

Blocklnfo^ lDi2, AddrRf3?::0)elKC90?X, Size:4 
File Minknown'; Line 0 

HiHt Sum of outKtandirg block sizes = 8 bytes 

Ibe log file contains some useful infonnaiion* as you can 
see. There are two outstanding blocks — the two TClietitObjecl 
objects tlial the pix)grani in Listing 2 oeglecied to delete. The new 
operator was called three times* and delete was called ont'c, 
which jilK.‘s with what we know from the example code. 

Because object 1 was created by the 'n-l_new macra. you 
can see exaaly where it was created and go back and make sure 
it gets deleted — a piet e of cake* even on huge projects. 

Unfortunately, we didn't use 'rH_new for ohjectZ, so 
TidyHeap logged its location as “unkiKmn/ However, you 
can tell which object it was by looking at its block ID. llic 
object has a block ID of 2 Bhx'klofo: ll);2), w^hich means 
it was created second, in the case of tiiis example program* 
iTs trivial to figure out which object was created second. It's 
not so trivial U) locate the client object that has a block il) of 
1,233 in a two million-line pnjjeci. Later, I’ll show you a 
i:ou[)le of advanced techniques for tracking down a block 
when all you have is its block ID. 

Actions 

With actions you can modify TidyHeap's tiehavior, the 
AC^CndyileapBlock object, or the dienl object that's Ix'ing 
operated on currently. Atlions are lightweiglu sulKlasscs of 
AC_Cridy Heap All ion. Tidy Heap’s ac'tion class architecture makes 
it easy to cusiomke and add features to TidyHeap. Read on to 
learn hr>w to insiall actions, use the actions tiiat ship with 
TidyHeap, and creaie your own actions. 

Installing into global and object contexts 

Action objetls are differentiated by their context. Tliere 
are two types tjf context: gkrbal and object. An action that's 
executed in a global context o[X.Taies on all alRjcaied obje< is, 
while an action that s exectited in an t)hject context o[KTates 
on only a single object 

TidyHeap manages two different lists of actions that 
operate in the global context — the global new and global 
delete actkms. When a global new^ action Is installed* it’s 
performed on every block of memtjry that's processed through 


Lisiittg 2 . Icamng umieleted ohjtH:ts 

#lnclude "UClientObjsct.b* 
jinclude -CTldyEeap^AC.b" 
void nairiO 
I 

TCI tent Object* objectl ” TH_new TClientObject; 
TCIlentObject" object2 = nev TCllentOb^ecti 
TCllentObject* object3 * TH„n€¥ TCllentObject: 

delete objectS: 

1 


new; a global delete action is performed on every block of 
memory processed thrf)ugh delete. 

For example, AC_CAct ion Verify Block is one of tlie acTion 
classes that ship witli TidyHeap. When an AC:_CActionVerifyl5lcKk 
action is insmUed as a global delete action, every block of 
memory is verified as it's luring deleted. You w^ould install an 
AC_CAc't ion Verify likK’k action as a glolial delete artion as tbUows: 

AC_CActldnVerifyBlock* tbfiAction = TU_nt?¥ 

AC. CActionVerifyEldck; 

AC CTidyH^ap: ;lni;L4tici?0 >AcquireDeleteAction(theAction) : 

Here’s the ccxle to install AC_CAclionVerifyBl<x.k as a gU>bal 
new action: 

AC .GTldyHeap: :InsTancc{3 >AcaLilj:eNttwAction(theAction) : 

All aclionSj once they're installed, are deleted 
automatically at the appro[)naie lime liy TidyHeap. The 
method names start with ^‘Acquire" to make it clear that 
TidyHeap owns the in.stalled actirm. 

When installing an action into an tjbje<T context* you can 
in.stall it only as a delete action. You do this by gelling the i^ointcr 
tcj the client ohjeas AC_ClldyHeapBlf)ck objed, and then calling 
the AC_CTidyHeapBlot:k class's At:qi lire Delete Act ion merhoct. 
Once an action is installetl in att object context* il wall l>c‘ 
performed once as the client object is lx*ing deleted. 

Listing 3 shows law to install an A(^_CActinnBreakOn[>elete 
adion. litis action aills DehugStr to break the program into 
Macs Bug when the client object is deleted. 
AC_CActionBreakOnDelete [>rovk!es an alternate method tor 
tracking down leaks. If you install this actum in a dieni object 
that y(>u're suspicious of, and your pn>gjam never gets the 
appropriate MacsBug message* ytni kn(>w the client object has 
leaked 'Ibe MacsBug message you would gel fnmi the program 
in Listing 3 when the bltK^k Ls deleted is "Deleting BU>ck 1." 

You don't have to use TH_new when creating 
AC^CTidyHeapAaion classes. TidyHeap's objeOs are tracked 
differently from client objects so that none of the TidyHeap 
classes will show up as undeleted blocks. 
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BiiilMn action classes 

TidyHeap .slii[)s wiili a haiRllul ofaaion das.ses. You can use 
some tjf iliese action classes in more than one context, h'or 
example, as shown In the previous section, you nin use 
ACM'AciionVcrifyhlock as a gbhal delete action, hut there's no 
reason why you can't alsti use it as a delete action assigned to a 
specific {jbjecr. Just lie sure to allocate a new action ohjtHi lor 
each C{)niext you install ihe action in. 

AC'Act ioiiHreakC)IIDelete ancl AC_C]AclionVerify Block are 
deseriix.‘d in the previous section. The remuming built-in action 
classes arc descrilK'd l>c'l(nv. 

AC_CActionBreakOnI\ew 

In the section ‘Warnings, Logging, and die Lug File” I 
[Ranted out that it can he extremely difficult to locale a client 
object witen all you have is the bkK'k II), TIk* action class 
A(-_CActionBreakOnNe\v helps you do this. You can install an 
AC_c;Act ion Brea kOn New olijeet as a global new action. 
AC CAetionBreak(;)nNew^ takes a long integer as a parameier in 
its eonstrucior; this [larameter reprcseriLs a block ID. When the 
dtciU oliject w ith the given II) is allocated widi new, the action 
will break into MacsBug. At this point you can do a stack entwf 
in your favorite debugger. Here's an cxam[>le where youVe tiy ing 
to track down the ehent object wath the block 11) i042^ 

AC GAction&i-eskOnNew* theAction TH_nev 
AC CAt:tiDnBres.kOTiftew( 1042) : 

AC_CT1 ilyHp.ip:'Ttvfif(} ->AcqulrfiNfiwArtion(th«Act 1 on): 

Another way Lo locate a dient object with a block ID is by 
using the liltR’k ID to set a conditional break(>oini in your 
debugger deep in the guts of Tidy I leap, l-or example, set it on 
the line in CridyHeap_AC.cp ill at increments the counter in lire 
nieihocl CreateBlock (currently line 2tS7^ l')lockPii->lld = f(k)unt). 


Lislmg JL ImUillin^ AC_C^€Uo}iBreak(JnL)elete 

^include "CTidyHeapActians_AC.h" 
void mainO 
t 

TCiientabject* myObject ^ TILnew TClit^ntQbjecU 
AC_CTidyHeapBlQCk* objBlock - 

AC_CTi dyHsap:: Tnntance {) ->fif?tBlnck(]iiyObject) i 
AC_CActlunHrt?akUriat!leLe* LheAclIoii = 'rH_rn>w 
AC_CAc tionB r e a k 0 nD eiet e; 

obj 11 ock-MoquireDeleteAction[theAction)‘ 
tieluLO myObJccL; 


AC_trTidyncap:TTealcBlock alloaiLes tlie menioiy for dient 
objects' AC_CTidyUeapBk)ck objects, 

AC^rAcljonMakeNew'Fail 

Tlie action da.ss AC_CActionMakeNewFail does w hat its name 
implies — it takes a long integer n as a constnitior parameter that 
tells the action lo inttke calls to new fail on the nth call. Install an 
AC^CActionMakeNewFail action tis a glolial new' action. 

AC^CAcUtHiVcrifyAll 

An AC_CAaionVerify'All action iterates through the list of 
currently allocated client objects and verifies them all, one at a 
lime. TidyHeap wairas you if it finds a corrupt objecL Ik wanted 
that tiiis significantly skrw^s down your applicatitm if installed in 
a global context- You can use the action elass 
ACLCActionVerifyAII in either of the action cuntexls, 

AC^ CActionDoubkDeleteWatcher 

Tlie atiion elas,s is pailiculady useful An 
AC_CAet ion DoLible Delete Watcher action marks the client objects 
sent Into delete as deleted, hut prevtaiis the memory' allocated 
for the dient object frtaii actually I>eing deleted. If the of>ject is 
deleted a second time, Ticlyi leap will catch iL 1’he downskle to 
installing AC_CAaionl>oub]er)eleteW4itcher is that objec ts being 
watched are never actually deleted. If you're having problems 
w'ith a dient object being deleted niuliiple times. I recommend 
cranking up your applicarion'.s memory partition and mnniiig 
with A<L<^/^ciionnoubleDcleleWalelier installetL ll will catch the 
double deletion as soon as it occurs. You can msrall an 
AC_CActionDoubleDeleteWalcher action either as a global ddele 
action or m a specific client object. 

Even when an AC_CActionl)oulileIX?leteWatcher action isn't 
installed, TidyHeap still looks out for doiil^le deletions. Evtay 
dient object that's deleted is marked, and if it comes through 
delete again. Tidyl leap catches it if ptxssible. I’he trouble is that in 
nonnal oixmiting circumstances, the s^^crond time through, the 
objed pointer is learning at invalid memory, so die “already 
deleted" mark may not be valid — anything could be occupying 
that memory. However, in my experience, double deletions 
usually happen within a veiy sliori lime of each oilier, so you have 
a decent cktnce of finding the memory still undistmlxd. As long 
as memoiy is undisturhed, TidyHeap catches the second deletion. 

AC_CActionVerifyBlock may catch a double deletion if it's 
installed as a delete action, because the memory the dient object 
originally occupied may be overwritten, in which case the markers 
will probably be invalid and you'll get a corrupied-object warning. 
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AC_CActioiiIixemptBlocks 

1 added The arfton AC_CAcEtonExeinptB!tK.‘ks so iim it 
would l)c* possifdc lc> idl Tidy Heap Lc> ignore certain objects. 
Ff>r example, there are a tew oiijecls that MacA[>[) Release 12 
creates during startup that are not deleted (this was done to 
optimize quit times). To ensure dial TidyHeap’s undeleied- 
block messages are accurate, you can exenqji those lilocks. 
Install the AC_CAcrionKxemptldocks action as a global new 
action. Listing 4 shows die code to dt> lids (the ctnie is taken 
from the sample application Skeleton that ships wadi MacAf)[>). 

AC_CActionGarbageIn and AC_CActionGarbageOut 

■Jhe AC„CActionGarbageln and AC_CActionGarl>ageOut 
actions fill the client object's memory with garbage values just 
after allocation and just IxTore deletion, respectively. The 
values are defined in the objects' class definitions as 
kGarbagelnValue (0xF5) and kGarbageOutValue (0xK6). The 
values arc meani to l>e reetignizalrle and to cause a bus error if 
dereferenced. Install AC^CActiouGarbageln as a glolnil new' 
action. You can install AC_CAciionGaiixigeOiit either as u 
global delete action or in a spcTific client objed. 

AC_rActJonKxeinptl 1 nknow'n Blocks 

With die AC^CActionExemptUnknownldocks action 
installed, Tidylleap tmly tracks objects created with Tll_ncw\ 
This is handy IVir times when you have a lot of undeleted 
Idocks and want to debug tho.se created with ']'H_new 
separately. I used this action when working widi MacApp 


Listing 4 hheks 

void ttifilnO 

I 

// Heir's when* ihi- rliou ulijccisi wt- wirii to rxcmiH aa* caiiltti. 

// tlie iioitin. 

AC_CTldylIeanAt t ioti* action ^ new 
AC_CAc tion Exe ap t B1cc k n: 

AC^CTidyllogpr: InstanceO ->AcqtiiretlewAttion (action 1: 

lTiitL)MacApp( 4 ); 

InltUFrintliiR(): 

InilUViewSkcletoriC): 

// Now we w;mi ti> ?4im locking olijfCl:». rrmovr the extmpter. 

AC CTidyHnap:; Instance f) >RenK)vetlewAction (action): 

// RcmmcNcwActiim ikirsn'I dclclf itn- mi wc do il imrsrives. 

delete action: 

TApplicationSkeleton' aApplicationSkeleron = 
nnw TAppl Icfiti onSkclcton ; 
aAppl icatlonSkeleton ■ > lApplicationiJkel eton (): 
aAppI teatJoitSkclelon XRuntJj 


Af 5 /iii^ 5. AC_CActionBreak(}riNew::i}()Aciion 

void AC CArtionBreakOnNetf ; i IloAction (AC^CTldyUeapUiiock* 
inSlock) 

( 

if (inaiock'>GetIDO =- fID) I 
chac strLSOj; 

T:aprinif(str, "AC_CActionBreakOnKew: Block ID: Sid”. 

rin); 

: ;cSpsU (air): 

:; OehngEit r ({St r 1 ngPt r) r): 

I 

I 


Release 12, which, as 1 noted above, deliberately doesn’t delete 
.some blcK'ks that w^^re created at startup time. It worked like a 
(“fiarm! Install AC_CAct ion Exempt Link nownBltKks as a global 
new action. 

AC^CActianlficremefitatNewFailer 

The AC_CAcLionlncremenl:ilNewFailer action is specially 
designecl for you QA hilks to make your engineers' lives 
ini.seraiile. AC^CActionlncremcnialNewFailer makes new fail 
setjtiemially — first new nunilx'r one fails, then number tw^o 
fails, then number ihree, and so on. The kicker is dial TidyHeap 
s;ives tile count into a text Hie so that the next new that will fail 
is ])ersisicni Ixjivvecn runs of your :ipplication. 'Ihis stresses your 
failure-handling code U> the limit! Install this action as a global 
new action. 

Rolling your ow n acli4>ii classes 

The ACLCTidyHeapAclion class is a very simple and 
ligluweighl class. To make your own action class, simply 
subclass AC_CTidyHeaf>Ai lion and override the pure 
viriual function DoAciion. M'he function takes as a 
parameter a pninter to an AC_CridyneapBlock object, 
which is the object Tidylleap is currently operating on. 
Listing 5 show^s the code overriding DoAciion for the 
A('_CActionBreakOnNew aeliim cla.ss. 

Changing Sm iNGs wi i n Tidyui-ap Dirix;ior 
ridyHeap WTites its current settings to a file named 
nmtfpliailkmpr/m your application's folder. It saves to this file 
any changes to Tidylleafi settings made fbetween runs of your 
application so that you can use the Tidylleap Director tool to 
edit tile file and (hunge the Ixdiavior of TidyHeap without 
recompiling your code. 

Figure 2 .shows (he Tidyllea]> Setiings File dialog lx>x. 
The apphcaTif)n you're working with appears after "Target 
Af>plicaLion." On the left are five Features preferences. 

• (^heck Enabled to turn Tidylleap on; unchecking tliis option 
effectively turns off Tidylleap completely. 

• Clieck Warnings to sentl warnings to MacsBug. 
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Figure 2 SeUin^ TidyHmp preferences with TidyHeap Director. 


• IF Warnings is cnal)icd, you can set Undeleted Blocks, which 
causes Tidy! leap to send a list of undeleted blocks to MacsBug 
when your application terminates. 

• Check Log Undeleted Blocks to enable logging of undeleted 
i:)locks to the log file (see tlie section "Using the Log File”). If 
you have mtiny undeleted blocks, the logging process can take 
a while and you may want to simt off the logging. 

• Check Pointers Live Only in App Heap to tell TidyHeap to 
verify tliat pointers you send into GetBlock or Verify Block are 
widiin your application’s memory heap. 

Use the checklxixes under Global New and Global Delete to 
automatically install the listed actions as global new or delete 
actioas when TidyHeap starts up. 

Tile settings file Is read once — when TidyHeap is created. 
I’o make changes to your settings, make sure your application 
isn’t limning at the time. The next time your applicuLion is run, 
your new settings will ix^ loaded. 

Alternative to I'tdyHeap 

There are other tools witli features similar to TidyHeap. 
This section tells you a little about some of them and 
compares them with TidyHeap. 

Metrowerks ships a tool called DebugNew. Youll find 
the library and a demo for DebugNew on the CodeWarrior 
CDs. DebugNew has some of the same features as 
TidyHeap, !>ui it’.s not a.s exlcn.sible and doesn’t have a.s 
many features. The features it does have are quite valuable, 
however: it can check for leaks, validate blocks of allocated 
memory, and verify that a block is in the application heap, 
DebugNew also has a macro like TH_new called NEW, and 
It has a log file. DebugNew is smaller than TidyHeap and is 
written in C, so it may run in a smaller footprint and it 
doesn’t require C++. 

Another tool for tracking memory leaks is the ZoneRanger 
application, also from Metrewerk.s. ZoneRanger is quite good not 
only at tracking memory leaks, but also at fine-tuning your 
application's heap and managing memoiy. This is a great tool that 
every programmer should have at hand. 


QC and Spotlight by Onyx Tcclinology arc MacOS system 
extensions that provide memory debugging for applic’ations 
without requiring that you modify the source code or recompile 
the application. QC stress tests applications for all kinds of 
memory-related errors. These tools work well with applic’atioas 
that directly allocate memory with the Macintosh Memc^ry 
Manager or that manage resources returned by the Resource 
Manager, and can be used in conjunction with TidyHeap. 

Memory Mine by Adianta is a standalone tool for monitoring 
heaps and stress testing applications. It flags heap corruption 
when it happens and you can see memory leaks as they occur. 
Source code is not needed to monitor heaps. 

Apple ships a handful of demds (debugger commands for 
MacsBug) dial arc extremely helpful as well: Blat makes sure diat 
nobody writes to the first 256 bytes of low memory, 
DisposeResource ('.atches resource handles dial are paxsed to 
DisposeHandle, Leaks watches for memory leaks when you tell it 
to (via “leaks on”/"leaks ofP commands to MacsBug), 
HvenBetterRusHrror watches for dereferences of NIL and writes to 
ML (location 0), and Xap fills pointers and handles that were 
disposed of with a value that causes a bus error if dereferenced. 
Furthermore, the useful system extension DoubleTrouble catches 
double disposes of a liandle. 

Another very useful tool from Apple is the Debugging 
Modern Memory Manager, which, not surprisingly, i.s a 
debugging version of the Modern Memory Manager. It performs 
many of the functions described in this article, including filling 
a client object’s memory with garbage, checking for writes pa.st 
the end of blocks, and checking for bad handles passed into 
Memory Manager routines. 

Terminate 

Well, there you have it. YouVe got TidyHeap hooked into 
your framework or application and you're ready to let it track 
your client objecLs and help you figure out where a leaky block 
was created, using either the TH_new macro or its block ID. You 
can now squash all your memory leaks with ease. You also 
learned abt>uL some of the more advanced features of TidyHeap, 
including the action classes that sliip with it. And, you're ready 
to use lidyHeap Director to modify 'FidyHeap’s behavior 
without recompiling yrrur applicralion. 

I hope that TidyHeap makes it possible for you to focus on 
making insanely great software without having to worry so much about 
the more irritating and mundane tasks of application programming, 
suclt as tracking undeleted t)bject>. Hiippy block liunting! 


Thanks' io our lecbnicai reeietwrs Brian Anioid, Paul Black 
Geoff Clapp, Mike Rossetti, and Jason Yea. Ki 
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by Dave Evans 


Code Mechanic: Better Than Ever Stress Testing 



Dave Evans 


TiiL-rc arc few things more frustrating 
than losing access to your debugging 
ttx)ls due to a freebie, because you can*t 
Fix what you can't diagm>se. The best 
course is to stop freezes before they start, 
so I’d like to share a common cause of 
freezes I’ve found. I'll also discuss some 
of the stress-testing options that are 
available to help you catch freeze-causing 
problems you might have missed ^ 
including an improved debugging took 

Veteran readers of develop may notice a 
new title for this column. The previous title, 
"Balance of Power/' was apt for its time, 
indicating a focus on PowerK issues. But 
now that all new MacOS computers are 
PowerPC-based, everybody's writing about 
PowerPC, and my efforts in this area are 
complete. This new title reflects a locus on the 
mechanics of code tuning, with tips for 
improving your application's performance and 
stability, which 1 hope you'll find just as useful. 

Protect Yolib Vectors 
Even if you use a PowerPC-based 
MacOS computer, the first 256 f>ytcs of 
memory are dedicated to 680x0 
exception vectors, which the 680x0 
software emulator uses to enmUlc 680x0 
exceptions and interrupts. On a 680x0- 
based computer, these values are read by 
the processor itself when liandling an 
exception or servicing an interrupt. 


tinder System 7, these important vectors are not memory 
piotecied, Any program can read from or write to Lheni, possibly 
resulting in a serious failure. While not all of the vectors are used, 
modifying some of them will cause an immediate freeze, leaving 
you without access to your debugging tools. You probal^ly don't 
address these vectors intentionally, but it often occurs 
ac:cidentally when a nil pointer or empty handle is de-referenced. 

Unintentionally reading from llvese vectors will produce 
a random result. In most cases the vectors are addresses of 
special system routines; these vectors can have any value, 
and they vary significantly from one compuler model ia 
another. As an example of how easy it is to cause a problem 
in this area, take a look at the following C code, similar to 
that found in some applications: 

ftoni_wlndDw = FrontWindowO ; 

If [f]:oiit_window >windowKind < O) 

MyDefikAccessoryRoutine(tront_window): 


Tlie developers didn't realize that ProntWindow can return 
nil when no windows are open. In that case the application de¬ 
references tlie nil pointer and makes a logical decLsion fjased on 
the sign of the half word at $(>C in low memory, which is the 
liigh half of tlie iniernipl level 3 vector. On most Macintosh 
computers released beftHe 1995, this vector pointed into ROM 
starting at address $408QO0(X). Because of this, tiie applications 
would test the high half word value of $4080, and they wouldn't 
run the desk accessory routine. Tliis was I he rigliL lx:havior, but 
for the wrong reason; disaster was averted by luck. 

Beginning with all PCi-based PowerPC computers, ROM 
siarLs at Iocatit>n $FFCOOOOD. During the development of these 
computers, we found tliat afiplications wiili code like the above 
would crash I^ecause they executed unexpected code after 
comparing the new half word value of $FFC0. We were able to 
work around tlieir f)ix>blem by changing the interrupt level 3 
vector to point to a routine in RAM. This changed the high half 


Dave Evans is a typical American breed, often Found hard at work on the Apple campus. Tie lacks a ]>ure pedigree, coming 
instead from Irish, Norwegian, ^Scotlisll, and Hungarian slock. T his mix gives him an even lempeniment and friendly demeanor. 
He makes a loving companion, good for playing catch or Fri.sbce, and he doesn't eat much. If you have a large yard, please 
contact your loc'al animal shelter or kennel for adoption details 
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wtjrd value to be a small posiiive number, and the applications 
IxHiaved as expected. Still, the Ixst case would have been if tlie 
prol’>lem could have Ixen avoided in die first place. The 
ldllowinj[r code is an example of what would have been a better, 
crash-free apprcxich: 

tront window ^ FrojiLWindowO i 

if (fronf_wlndi>w fr£itit_wind£iw->windovi'Kin,d C 0) 

KyDeskAcceKSoryRoutine(front_wlndow): 

Chet^krng for nil fx>intcrs or liandles is one way you can avoid 
tiiese crashes in the first place. Checking for empty handles is 
another necessary step, sinc:e unlocked relocatable blocks that are 
marked purgeable may disappear any time memory can move. 

To deteta problems with purgcable bkxtks, you 11 need tmils 
to stress test your application. Utilities that display heap mnei^, 
allowing you to compact and purge a heap on demand, are a 
good start. For serious testing, however, you'll need a stress tool 
that operates all the time. One good tool for diis is MemHell, 
which will compact and purge your heap whenever a Memory 
Manager routine that might move or purge memory is called. 
This slows down execution of your tests, but tt will flush out 
[)rol)lcms with purgcable blocks. 

So, while iuxadentaUy reading from low memory can cause 
unexpected results, accidentally WTiiing to low memory can be 
fatal, and this is one of die most c'ommon causes of freezes that 
I've noticed. You rnay think this could never happen in your 
code, Ixcause none of your blocks are purgeable and you 
always check errons after allocating pointers. Think again; there 
are plenty of other opportoniiies. Do you check for an error 
after every GetRes^^u^l:e call? Getting an unexpetietl error — 
from a corrupted resource file, for example — is one way you 
can end up with a nil handle. Besides diligent review' of your 
code, you need to do stress testing to flush out possible errors, 
ur freezes are likely to resulL 

Ake Yoo Stressed ENOLfGU? 

There are a number of tools to help add stress to your 
testing. Tve already mentioned McmHeil for fincling problems 
with purgeable lilocks. You'll similarly need a tcxil to find reads 
and WTitejj to the exception vectors. 

Tile simplest choice Is the ubiquitous and venerable 
EvenBetterBusError, written by Greg Marriott, This tool 
safegtiards the first four bytes of memory, which are very 
often accidentally written over or read from, I'o detect reads, 
it places in tlie first four bytes of memory a value which when 
de referenced will cause a crash. If you use a nil pointer or 
empLy handle, the illegal value is likely to be used as data or 
de-referenced, leading to a crash. To detect writes, it checks 
perif>dicaliy to see if the value that it j)laced has been 
overwritten; if so, you'll be notified with a DebugSlr message. 
FvenBclterRusFrror is included as a demd in MacsBug 
beginning w'ith version 6.5,4, 

I've extended EveiiBcLierBu,sHrrQr to lx more aggmssive, 
Ibe new version, Yet EvenBetterBusError, wxites a value over tlie 
first 256 bytes of memory which will cause a crash into your 
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debugger when dc-rcferenced. it also checks periodically tor 
writes to these locations, but more Frequently than 
Even Belter Bus Error does. Like EvenBetterRusHrror, upon 
noticing a write to these ItKatioas it will notify you with a 
Debugstr message. YetEvenBetterBusError can lx found at 
<hltp://www,mactech.com>. 

To implement YctEvenRetcerBusError, I had to sacrifice 
some compatibility witli existing applications. Any application 
code that assumes the exception vectors .stan at address 0 will 
no longer runcUon corrccily. Most applications don’t u.se the 
exception vectors directly, but some copy protection schemes 
do modify the vectors, 

llie coiTcct way to determine the kxation of the exception 
vectors Ls by using the 6B0x0 instniction MOVEC, which must 
always lx execruted in sujxrvisor mtxle. The Icxation of the first 
vector is .stored in llic 680x0 VBR {Vector Base Register), lY) read 
the adciress, you would write the following assembly code: 

„EnterSupervisorMode ; old sr result in dO 
niDvec vbr.aO ; get ihe vbr 

move.w dO.sr : resLore the old sr 

Always use Uie VBR to find these vectors. Alihi>iigh early 
versioas of the MacOS always placed them at location 0, theyTe 
now often elsewhere. When virtual memory is turned on, for 
example, the vecu>rs will actually reside in the system heap, 
and the VBR will point to them. To maintain compatibility, 
however, if virtual memory doesn’t handle an exception it calls 
through to the original vector table at location 0. This is why 
even with virtual memor>' on, writing over the low-mcmory^ 
exception vetiors can still cause a freeze. 

YetEvenBetterBusError is able to overwrite and then monitor 
the first 256 bytes of memory by moving the excej>lion vec:tor 
table entirely. So, even when virtual memory is on, with 
YetEvenBetterBusError installed the original low-memory veaors 
are never called. This is why some existing applicatioas may be 
inconipatihle with YetEvenBetterBusEiror. 

A Cure for Te.st Aistjoety 

It's true that fully testing your code to reflect all possible 
configurations and u.ser actions can be a neur-impf>ssible task. 
Rut the perceived stability of both your application and the 
computer depends on how well we all write and test our 
software. To do the best possible job, u.se the stress-testing 
tools mentioned in this column or in the article St|uashing 
Memory Leaks with Tidy Heap" in this issue. Do the right 
thing: stress test, then relax! 


Thanks lo Pete Cornier, Chris JallxTi, Bojh Johnson, Dam 
Lyons, Quinn 'The Fskimof\ and Kciih Siatleufield for 
iig this coiumn B 
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Apple Developer Support Center 


Macintosh Q & A 


Q; How can I determine whether my 680x0 program is 
running on a PowerPC machine? 

A: The best way to do liiLs is to use the Gestalt selectors as 
described in the Universal Interface file Geslalt.h: 

enuu I 

gestaitSysArchite^cture * "aysa*. //Native archit<rctiirc 
gestaIt6Bk = 1, //McHUfola M{'(i8(>x0 archjicOtim 

gefltaltPowerPC = Z //IBM PowcrlC arrhiteaure 

h 

A snippet of code that uses this would look something like 
the following in your 680x0 pmgram: 

long myattri 
OSErr erri 

err = Geslallt gestaltSysArchitecture, ^iiiyattrh 
if (err = noErr) { 
if {niyattr — gestaltPowfirPC) 

// DtJ swmr ftjwcrPC thing, 

I elee I 

// Handle ihe nTi>r condiiiun 

1 *** 

Q: Fve created a dialog box that has two editable text fields 
in it and Fve used an 'ietb' resource to change the font 
and the size of the fields to 10-point Geneva. When I 
move the insertion point into the second field and 
delete a character, the character just before the one I 
deleted drops down a couple of pixels and overwrites 
itself* What can be done about tills? 

A; You've run into a problem with the Dialog Manager's 
support of 'ietb^ resources* The Dialog Manager forgets to 
reset some of the fields of the 'lextHdit record when it 
swaps the font and font size information stored in the lctb\ 
You need to reset the fontAscenl and lineHeight fields of 
the TextEdit record to match the size of the font specified 
in the 'iab^ By default those fields are set to the Linelleight 
and fontAscenl of 12-point Chicago. 

The following code shows how to set up the TextEdit 
record properly. 


static void SetUpEditFieldCDialoglef diog. short fontHim. 
short fontSize) 

I 

Fontlrifo info: 

BlalogPeek dpeek “ (Di3logFeek)dlog; 

if fdpeek t" nil) t 

TEHandle = dpeek->textH; 
if (re 1^ nil) 1 

short oldFont ^ dlog->txFont: 
short oldSlze = dlog->txSi 20 : 

TextFont(fontHum): 

TextSizeifontSize): 

GetFontlnfo(Mnfo): 

// Ftx dieTF necofd. 
te|0j >txFont = fontNum: 
tefo]OtxSlKe " fontSlzei 
// Czlculaic the cornea line height. 

te [0]*>lineHelght = info.ascent + info.descent + 
Info.leading; 

telflj ■>fontAscent = info.ascent: 

TeXt Font (o 1 d Font): // Roict the font Mo. 

TextSiKeioldSize): 

1 
I 

] 


Tlien call Set Up Ed it Fie Id in your dialog routine, like this: 

static short DoDialog(short resID) 

I 

DialogRef dlog: 

GrafPtr oldPort: 

short ItcaHlt 0; 

Get Fort EAoldPort); 

dlog “ GetNewDialog(resID, nil. (WitidowRef) -1): 
if fdlog) I 
SetPort(diog): 

SelectDialogIteiiiText(dlDg, 2, 0x8000, DxBOOO) : 

// Set the curaor. 

SetUpEditField{dlog. geneva, 10): 

// Sc* the edit field. 

(vold)SetDialogDefaultlteiii(dlog. 1} i // HiphUgln OK buitoti. 
ShowWindotf (d 1 og); // Show ihc dialog 

while (itemiiit != ok) 

ModalDiaiogfnil, ^itenHlt); 

SetPort(oldPort): 

Dispos€Dialog(dlog] ; 

1 

return ItemHit; 

1 


Of course, an alternative to all this is to avoid the Dialog 
Manager altogether and Lherel)y avoid these obst:ure Dialog 
Manager problems. B 


//GatheTEHandlc. 

// Save old font info. 

// Set correct font Mo. 

//Set font 
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For Macintosh 
Programmers & Developers 



REDUCED 


PRICE! 

Limited time offer: Buy 
Volume 11 NOW , and get a 

free upgrade to the soon- 
to-be-released Volume 12! 
(Free shipping on the upgrade!) 


Subscriptions; US magazine: $47 for 12 issues (MTYROM) 
Canadian; $59 for 12 issues (MTYRCM) 

International: $97 for 12 issues (MTYRFM) 

Back Issues: $10 each (subject to availability) 


MacTech CD-ROM Volumes 1-11 

• 1420+ articles, from all 127 issues of MacTech Magazine (1984-1995) 

• Improved hypertext, and a new THINK Reference Viewer - for lightning 
quick access! New hyperlinks between articles 

• 100+ MB of source code - use liiem in your applications, 
with no royalties! 

• Full version of THINK Reference^** - the original online 
guide to Inside Macintosh. Vols. I-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of 
Frameworks archives known 

• Sprocket"! Mac Tech's Tiny Framework that compiles quickly 
and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups 
plus thousands of notes, tips, snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

List Price $89 Our Price $79 (SMTCD11) 

Upgrades; Our Price $39 (SMTCD11U) 



RICE! 


The Best Of MacTutor Volume 4 


List Price $29.99 Our Price $4,99(bbest4) 



MacTech Mouse Pad 

Slide on this! With an extra-large surface {11" by 10") and 
a deluxe sleek plastic coating, you’ll be zooming across 
your screen in no time at all. Speed limit not enforced! 

Our Price $8.95 (amtpad) 
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System 7.5 Technologies 

by Apple Computer, Inc. 

• Self-paced course designed to allow software 
developers to write code that extends the 
functionality of an application for ^tem 7.5. 

• Contains comprehensive materials for drag-and 
standard mail package, and QuickDraw GX printing. 


Students should be familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed In CodeWarrior 8. The labs can also be done in another 
development environment but project files for them are not provided. 


Training Format: Tutorial with labs. 


Requirements; Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred); 8 MB RAM; 25 
MB hard disk space; System 7.5 or later; CD-ROM drive. 


Our Price $49.95 (SSYSTTCH) 


Virtual Thtor for QuickTime VR 



Apple Guide Integration 

by Apple Computer, Inc. 

• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide Into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 

Training Format: Overview with labs. 

Requirements: Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

Our Price $49.95 (SAGi) 




T 

Newton 



Newton Toolkit 1.6 


By Apple Computer, Inc. 

• Self-paced, hands-on course, which 
provides a comprehensive environment for 
learning the steps of the OTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on, Topics covered Include; QTVR 
capabilities and key concepts, panoramic 
movies, object movies. QTVR Scene 
movies and authoring with OTVR. 

• CO-ROM contains lots of useful examples 
and demos. In addition to all the step-by- 
step exercise files. 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title lhal comes on the 
enclosed CD-ROM. There are approximately 
3-4 days of training. 

Training Format: Tutorial with labs. 

Requirements: 40 MB RAM minimum, 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
processoror greater; System 7.1 or later; 
CD-ROM drive; 17“color monitor. 

List Price $79.95 (SVTFOTVR) 


With Newton Toolkit, you can easily create 
software that runs on any Newton PDA. 
including Apple's MessagePad and Motorola’s 
Marco. 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactively 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 

Our Price $299 (SNETO) 

Newton Toolkit Update 1.6 
Our Price $49 (SNETOUP) 



AppleScript Software 
Development Toolkit 1.1 

• AfjplexScript language, system software 
extension, and script editor 

• FaceSpan 1.0 

• Developer's redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 

Our Price $49 (SASDT) 


Newton Programmer’s 
Guide for Newton 2.0 


• The Newton Programmer's Guide consusts 
of two volumes covering ttie Newton 
System Software, and one volume 
covering Newton Communications 

• The two-volume set. Newton Programmer’s 
Guide: System Software, is the definitive 
guide and reference for Newton 
programming. This set of volumes explaitis 
how to write Newton programs and 
describes the system software 

routines that you can use to do so 

• The Newton Programmer's Guide: 
Communications, describes the Newton 
communications system software for version 2.0 

Our Price $149 (BNPGFN) 


|| Appl£Dylan 

Apple Dylan 
Technology Release 

• Contains a PowerPC-native prototype 
version of a development environmenl 
based on the Object Oriented Dynamic 
Language (OODL) Dylan. Developers will be 
able to produce code targeting both 680x0 
and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface 
&builder 

• High-level exception handling 

• Cross-language support for C code and APIs 

CD & Online Documentation Our Price 
$39.95 (SADTRO) 

CDS Hardcopy Our Price $59.95 (SADTRH) 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Apple Media Tool Programming Environment 2.0 

• This object-oriented language and application framework allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

• Includes an expanded Apple Media Language (AMtj class library, 
incremental compiling and linking of AML code, fasfer debugging 
facilities, Macintosti Programmers’ Workshop (MPW), and user-oriented 
documentation written from an AMTPE developer’s perspective 

• Portable across 68K, Power Macintosh, and Windows platforms 

Our Price $996 (SAMTPq 


Multimedia Authoring with Apple Media Tool 

by Apple Computer, lire. 

Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minima! learning time. This self- 
paced tutorial will make Apple Media Tool (AMT) even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime movies, 
animation and more. A demo version of AMT is included and can be used 
for the exercises. Training Format: Tutorial with labs. 

Our Price $49.95 (SMWAMT I 



Virtual Reality 

Programming 

with QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virtual Reality Programming Book/CD-ROM 
for QuickTime VR 2.0 

• Enables you to write C and C++ programs 
using QuickTmeVR 2,0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, panned, or linked wilh hols spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 

Our Price $49 (SVRPOT 



QuickTime Developer’s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension, QuickTme Power 
Macintosh Extension, and QuickTme 
Musical Instruments extension 

• Utilities like MoviePlayer 2.0,16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, 

Time-Code Movies, and 60 field per 
second movies 

■ Includes software-only playback features 
such as faster 2x playback mode for 
current compressors, Ap[)lH Cinepak 
compressor, 1 -bit fast dithering, network 
tuning, load-into-RAM option, and Photo 
CD support 

Our Price $99 ^QTDK) 



Object-Oriented 
Fundamentals 1.1 

by Apple Computer, Inc, 

• DU'S multimedia Object-Oriented 
Fundamentals course enables you to easily 
make the paradigm shift from procedural to 
object-oriented design. It will introduce you 
to the entire object skill set, from general 
concepts through analysis and design 

• This course includes a lite" version of 
Metrowerks CodeWarrior integrated 
development environment for use in the 
labs, This course also includes a copy of 
the book Learn C++ on the Macintosh by 
Dave Mark 

Our Price $245 (SOBORFU) 


QuickTime VR 2.0 
Authoring Tools Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software 
from Apple whicii enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTme VR 
content. With QuickTme VR, users 
interactively navigate through 360* views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTme VR Authoring Tools Suite is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated Images 

• Included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTime VR 
pwioramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are; 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime 
VR objects to scenes 

• A variety of utility tools for formatting the 
data into the 

runtime software 

Due to a revolutionary distortion-correcting 
algorithm, QuickTme VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed of toe 
algorithm allows up to 24-bit color Images. 
Both vertical and horizontal panning can 
occur at fast speeds. 

Our Price $395 (SQTVRATS) 
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Audioiyack 

by WAVES 
AudioTrack is a 
software plug-in for 
native processing on 
digital audio 
recording and 
editing systems. 
Waves AudioTrack combines the most- 
needed audio processors into a single 
piece of software, including 4 bands of 
equalization, compression/expansion, and 
noise gating. AudioTrack is ideal for 
preparing audio for InterNet streaming 
formats, processing individual 
mono/stereo tracks of audio and audio 
for video editing systems including digital 
sequencers. 


Feature list 

• A single window interface 

• 4-band ParaGraphs Equalizer, 
Compressor/Expander and Gate 

• Instantaneous A/B comparisons of on¬ 
line settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
(requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements: 

The AudioTrack Is compatible with all 

machines supported by Deck II, 

SoundEdit f6, Adobe Premiere 4.0 and 

Cubase VST 3.1. 

Our Price $270 (SAlffilOTRK) 



Order ToH-lree 
800-1IUCDEV-1 


|il(]0622-33iil| 
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Native PowerPack 

by WAVES 

Waves Native PowerPack - a 
complete pro audio system of Waves 
software that utilizes native 
processing within the computer, 
requiring no additional hardware. The 
Waves Native PowerPack is a 
complete effects processing solution 
for those making records, creating multimedia titles, authoring audio 
for the InterNet, designing sounds for games, or recording at home. 

The Native PowerPack is available on the Macintosh for Macromedia 
SoundEditie and Deck II, Adobe Premiere, Bias Peak, Steinberg 
Cubase VST and Digidesign Audiosuite, and on Windows95 and 
WindowsNT using Microsoft ActiveMovie architecture to support 
Sonic Foundry Sound Forge, Steinberg WaveLab, Twelve Tone 
Systems CakeWalk, and other platforms that are using Microsoft 
ActiveMovie architecture. 

Native Power Pack for Mac or PC includes; Li - Ultramaximizer peak 
limiter, Q10 - Paragraphic EQ. Cl - Compressor/gate, SI - Stereo Imager, 
TrueVerb -virluat/space reverb, and WaveConvert - Batch converter. 

Our Price $600 (SNPWRPCK) 


WaveConvert 

by WAVES 

WaveConvert is an easy to use cross- 
platform audio processing application 
for multimedia developers, tfs ideal for 
all multimedia audio productions, 
delivering loud and clear audio files. It 
combines the well-known peak limiting 
technology of the Waves LI 
Ultramaximizer with other Waves processors into a powerful audio 
processing tool which offers one step conversion of multiple files. 

• Sample rate conversions from 5kHz to 48i<H2 

• Audio level normalization 

• Preview function 

• Stereo/mono conversion 

• Tone and gain control 

• Reduced background noise 

• 16/8 bit conversion using special audio maximization techniques 

• Preparation for RealAudio 

• AIFF, ".snd”, .wav, SDH, and RAW formats 

Our Price $270 (SWAVECON) 





ClipVR”* 

by eVox Productions 

Clip VR" is a new digital image library 
Offering high quality Photographs Virtual 
Reality (PVR) images for use with Quicklime* 
VR and other desktop VR tools. 


CrtpVR “ Panoramic Image components include 
a|3ha channel masks. Combine elements into a 
composite panorama which is converted to 
the finished QuickTime VR movie using Make 
QTVR Panorama Tool. The Components 
(“Clips") include complete 360 degree 
scenes, libraries of 360 degree terrains, 360 
degree skies, buildings, and objects. Images 
are provided as .PICT files AND QuickTime VR 


movie files. Clip VR^“ allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR™ 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging 
editing program such as Adobe Photoshop" 
to perform .PICT image compositing. 

Our price $89.95 (SCLIPVR) 
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Hyperprism-PPC Real-Time 
Sound Effects Processing Software 



! Hyperprism-PPC is highly flexible and creative effects processing 
I software for the PowerMac. Its unique Blue Window™ interface 
1 allows for dynamic, on-the-fly, "analog-like" gestural control over 
! multiple effects processing parameters simultaneously. 

i 

: • 24 high quality real-time processing algorithms 

• Non-destructive, dynamic, multipass processing 

• Presets provide ready-to-use settings for instant results 
' • No additional audio hardware is required 

• I/O is also possible with 3rd party sound cards 

' • Supports mono/stereo Sound Designer tl/AIFF files. 8/16 bits at 
standard sample rates 

Requirements: Power Macintosh or Mac OS-compalible with 
PowerPC processor; 8 Mb RAM; 1 Mb HD space; System 7.1 or 
later; Sound Manager 3.1 or later recommended. 

List Price $300 (SHYPERPPC) 

Hyperprism-MMP (Multi Media Producer) 
Real-Time Sound Effects Processing 
Software 

by Arboretum Systems 

Hyperprism-MMP is a package of highly flexible and creative effects 
processing plug-ins for applications supporting the Adobe Premiere 
plug-in architecture. 

Requirements: Power Macintosh or Mac OS-compatible with 
PowerPC processor; Adobe Premiere-compatible host application: 
3mb RAM; Imb HD space; System 7.1 or later; Sound Manager 3.1 
or later recommended. 

List Price $250 (SHW¥RMMP) 

Hyperprism-TDM Real-Time Sound Effects 
Processing Software 

by Arboretum Systems 

Real-time sound effects processing software dedicated to the 
Digidesign TDM NuBus platform. Hypeqjrism-TDM is considered as 
the only set of Plug-Ins on the market to cover most of the needs of 
professional recording studios and post production houses.ce. 

List Price $845 (SHYPERTDM) 


Hyperprism-68K Real-Time Sound Effects 
Processing Software 

by Arboretum Systems 

Hyperprism is a real-time sound effects proc^sing software for 
Audio Media l&ll, Sound Tools l&ll, or Pro Tools 442 NuBus systems. 
It takes full advantage of the 56K DSP (Digital Signal Processor) that 
resides on Oiese audio cards and works great on faster Macs such 
as Quadras. 

Requirements: Any Macintosh running System 7.0 or higher with 
NuBus slots and either a Sound Too! l&ll, or Audio Media l&ll, or Pro 
Tools 442 systems; 8 Mb of Ram; 6 Mb of HD space. 

List Price $389 {SHYPER68K) 


Ionizer Real-Time Dynamic Spectral 
Reshaping Tool 

by Arboretum Systems 

Ionizer is a real-time 512-band 
gated equalizer and multiband 
dynamics processor. Typical 
applications for Ionizer include 
broadband noise reduction, 
audio restoration and repair, 
mastering, multimedia, 
broadcasting, sound design, special effects, and anywhere you need 
powerful EQ and dynamics control. 

Requirements: Power Macintosh or Mac OS-compatible with 
PowerPC processor; 8 Mb RAM; 8 Mb HD space; System 7.1 or 
later; Sound Manager 3.2.1 or later recommended. 

List Price $800 (SIONIZER) 


Captivate 4.6: 

Essential Graphics 
Utilities 

by Mainstay 

Captivate™ 4.6 is a powerful collection 
of graphics utilities for Macintosh, based 
on Mainstay's acclaimed screen capture 
utility, graphics and multimedia scrapbook, and graphics viewer. 
Captivate provides essential graphics utilities to the professional 
and hobbyist alike. 

• Package includes: Captivate Select, Captivate View, and 
Captivate Store 

• Any one of the three can be used alone, and together they 
make an unbeatable team 

• Whether writing a training manual, creating an ad. or just 
creating a startup screen from your favorite picture. Captivate is 
everything professionals need at a price anyone can afford. 

Our Price $79 (SCAPTIV) 
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CodeWarrior Gold 11 

by Metrowerks 

• New improved IDE - graphical browser 
view, new project manager, global 
preferences and an improved external 
editor, easy-to-use IDE supports C/C-I-+, 
Object Pascal and Java 

• Full Java toolkit: project manager, linker, 
editor, class browser, source-level 
debugger, applet viewer and more! 
Everything you need for industrial-strength 
programming 

• New Object Pascal crr^s-compiler and 
New MPW Object Pascal compiler, Develop 
for Macintosh, Power Macintosh. Windows 
95, Windows NT, Magic Cap and 8eOS 

• Includes early release ActiveX Support and 
new VSC interface Version Control Support 


• Includes improved JAVA support, an 
alpha version of the new Version 2.0 
GW IDE, on-line books, extensive 
reference material and Apple Guide 
files for easy navigation through 
tutorials and examples 

• Two free updates and technical support 
included with registration 

Our Price $399 (SCWGOLD) 

SEE REIATED PRODUCTS; • Code Manager 

• Inside Power Plant • Inside CodeWarrior 9 
•C++ Programming with CodeWarrior 

• PowerMac Programming Starter Kit 

• Discover Programming for Macintosh 

• Learn C on the Macintosh 

• Metrowerks CodeWarrior Programming 



CodeWarrior Wear (xl only) 

You live it, you breath it... you might as well wear it! 
• Black CodeWarrior Sweatshirt: 

Our Price $29.95 (ACWSWEAT 


Feel 

abour 
^ purchi 


• "Blood, Sweat & Code” black short-sleeve shirt: 

Our Price $9.95 (ACWSBLOOD) / ”** 

• Hawaii Five-O shirt: 

Our Price $7.95 (ACWI lAWAift 

• Hat: Our Price $14.95 

Please Specify: Black (ACWBHAT) or White {ACWWBt lAT) 

• Winter Hat (see Web site) 

Our Price $14.95 (AWINHAT) 





CodeWarrior for BeOS DR2 

by Metrowerks 

• Start programming for the new, innovative 
Be Operating System (BeOS) with 
complete set of Codewarrior tools 

• BeOS-native Integrated Development 
Environment (IDE) with all the familiar 


BBiQS 

CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, 
an editor w/syntax color and styling, 
and a soi ree level debugger 

• BeOS header and libraries, complete 
documentation, useful C+-+ classes, 
and sample code 

• The Be Operating System DR8.2 for 
Power Macintosh allows you to run and 
program for the BeOS on a 603 or 604 
PCI based PowerMac 

Our Price $149 (SeWFB) 


CodeManager 

by Metrowerks 

• Source code control system, plug-in 
to the CodeWarrior IDE 

■ Compatible with Microsoft Visual 
SourceSafe version 4.0a 

• Cross-platform support (Mac. 

Windows. UNIX. OS/2) 

• Configuration management in excess 
of 4 billion files 

• Over 8,000 files and sub-projects in a 
single sub project 

• Registered users receive one year of free 
technical support anti two free updates 

• Includes a 1-year MacTech 
subscription. 

Our Price $399 (SCDMGR) 


Web site: http://www.devclepot.com • E-mail: orders@devdepot.com 
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Order Toll-free 
800-MACDEV-1 

(B0W22-3381! 


Roaster Release 3 is now available and shipping! Get the most out of 

Sun's Java™ programming language witii this powerlul 

development environment. 

• Features include: ability to build completely stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platform zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JDBC included; Java object 
database included; ability to call AppleScripts from Java; Just-in- 
time (JIT) compiler; JDK 1.0.2 support; class tree and hierarchical 
class browser; much morel 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software's JDBC Drivers; DpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3,0; much morel 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web-based updates 

List Price $99 Special Introductory Price! $49 (SROAST3) 





^Roaster] 


TH£ DEVELOPMCMT 
ENVIRONMENT FOR JAVA" 


Roaster 

by Roaster Technologies, Inc. 



Symantec Visual Cafe 

by Symantec Corporation 

Symantec Visual Cafe for Macintosh or Windows gives developers 
tine fastest, most productive visual programming erwironment ever 
for creating Java applets and applications 


• Drag and drop visual programming, easy to learn and use 

• Flexible development environment, two-way programming 

• Comprehensive component library, create re-usable templates 

• Extensive Java toolset and the fastest compilers 

Our Price $199 (SVCAFEMAC) 

OR Our Price $199 (SVCAFEWIN) 


TM 


SYMANTEC. 



LS Fortran Pro 

by Fortner Research LLC 
LS Fortran Pro is an ANSI standard Fortran 
77 compiler with extensions for Fortran 90, 
VAX, Cray, Data General, and MS PC 
Fortran. The package includes both the 68K 
and Power Macintosh versions of the 
compiler tor MPW, as well as Power 
Macintosh versions for use in Metrowerk’s 
Codewarrior or Symantec Project Manager, 


• Easy to use and produces robust 
optimized code, wide range of 
extensions, porting code from mainframe 
computers is effortless. 

• Supports the Macintosh toolbox, provides a 
full-feature Macintosh output window and 
offers simple commands for adding a 
Macintosh user interface. 

• Also included: Math77, a library of 
mathematical subroutines for the 
computational analysis of scientific data; 
Source Code Analyzer, a powerful static 
analyzer that is extremely useful in 
successfully porting large applications, 
and for debugging programs with 
extensive use of Macintosh toolbox calls; 
and the HDF Libraries, standard data 
format libraries for effecient storage of 
many types of ascientific data. 

Our Price $595 (SLSFORT) 



LS Fortran Plug-In 

by Fortner Research LLC 

Codewarrior owners can now experience 
the power of Fortran. The LS Fortran Plug- 
In for Codewarrior and Symantec Project 
Manager, allows programmers to write 
and compile Fortran programs in the 
popular, easy-to-use GUI environment, 
and effortlessly link Fortran with C and 
Pascal code. 

Our Price $199 (SLSFPI) 
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Check out our Web sitei 

• Full product descriptions • Hundreds of more products 

http;//www.devdepot.com 


F77 SDK 

by Absoft Corporation 

For Power Macintosh includes a giobally optimizing native compiler 
and linker,native Fx™ multi-language debugger, and Apple's MPW 
development environment 

• The compiler is a full ANSI/iSO FORTRAN 77 implementation 

• Includes all MIL-STD 1753 extensions, Cray/Sun-style POINTER, 
and several FORTRAN 90 enhancements 

• MRWE, Absoft's framework library is included in the MIG 
graphic library 

• Supports the native Macintosh PPG toolbox 

• Includes Absoft's Fx debugger which can debug intermixed 
FORTRAN 77,0, C++, and PPC assembler 

• The linker compiler, and debugger all run as native PPC tools, and 
produce Macintosh PPC executables 

Our Price $589 (SF77) 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface, 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new confrol constructs 

• F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

Our Price $899 (SAPROF) 


VIP-BASIC”: Visual 
Interactive 

Programming in BASIC 

by Mainstay 

Now you can create fulMeatured, 
stand-alone Macintosh and Power 
Macintosh applications in just minutes 
— in standard BASIC codel 

• VIP-BASIC’■“ 2.0 is the fastest way to program your Macintosh. 

• Rapid Application Development Environment with Application 
Framework included 

• Intelligent Dispatcher/Resource Editors and Prewritten Toolbox Calls 

• Mix and Match: VIP-BASIC high-level subprograms, standard 
BASIC libraries 

• Macintosh Toolbox calls can be used interchangeably to give you 
me flexibility 

• Includes Powerful Debugger: tightly Integrated visual debugger 
allows program tracing 

• Import Pre-Existing BASIC Code: Automatically integrate BASIC 
code 

■ Export C Code for Compiling: Automatically convert your BASIC 
code to C for compilation with Metrowerks CodeWarrior®, 

• Includes Fuil-Featured Mini Database: (limited to 32K) of the 
powerful VIP-BASIC Database Manager gives you everything you 
need to setup royalty-free, multi-user database applications. 

Our Price $195 (SVIPBASIC) 


VIP-C ”: Visual InteracUve 
Programming in C 

by Mainstay 

Now you can create fLill-featured, 
stand-alone Macintosh and Power 
Macintosh applications in just minutes. 
Vip-CTM 2,0 is the first rapid application 
development system for creating 
complete Macintosh programs in 

standard ANSI C. Everything you need is in this box! 

• Rapid Application Development Environment: Create lull-featured 
Macintosh apps 

• Application Framework Included: set up a bulletproof main event 
loop and routines 

• All source code for the application framework is included with VIP-C 

• Intelligent Dispatcher/Resource Editors and Prewritten Toolbox Calls 

• Reduce Complexity in Mac Programming widi High-level function 
libraries 

• Mix and Match: VIP-C high-level functions, standard C tibrahes, 
and Mac Toolbox calls 

• Includes powerf ul, tigntly integrated visual debugger 

• Import Pre-Existing C Code: Automatically Integrate C code witti a 
current project. 

• Includes Fuil-Featured Mini Database: (limited to 32K) of the 
powerful VIP-BASIC Database Manager gives you everything you 
need to setup royalty-free, multi-user database applications. 

Our Price $295 (SVIPC) 
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Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, 

and stress 
test applications 

• Active status of 
memory in a heap is 
sampled on the fiy: 




f( 


allocation in non-relocatable (Ptr), relocatable (Handle) and free 
space is shown, as are lieap corruption, fragmentation, and more 
■ Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 

Ust Price $99 Our Price $94.99 (SMEMMINE) 


NS BASIC 3.6 
for the 
Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation of BASIC programming language 

• Runs entirely on the Newton - no host Is required 

• Create files, access the built-in soups, and the serial port 
input and output 

• Work directly on the Newton, or dirough a connected Mac/PC and keyboaf 

• Get the BASIC Internet Tool, available at no charge to NS BASIC usei 
from ww/w.nsbasic.com. 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the Newto 
Internet Enabler. Also runs on MP 12Q1s with NOS 2.0 that have fi 
memory available 

• Write short programs to access News, mail and the web 
List Price $99 Our Price $94.99 (SNSBASIC) 


Water's Edge Software 


Tools Plus libraries + framework 

by Water’s Edge Software 

Easily create compact, fast running, professional looking applications and 
plug-ins*. Tools Plus lets you create virtually any user interface element 
with a single routine, and it transparently provides a robust infrastmcture 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! 

MacTech (July 96): "it's an incredibly rich collection of tools... If you are 
interested in developing applications that have ‘quaiity’ written all over 
them, then Tools Plus is for you." 

• Simplifies programming and thins source code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes and too! bars to 
powerful picture buttons 


• Includes numerous 3D grayscale options 

• Over 1/2 MB of custom fonts, icons, cursors, and other resources 

• Includes SuperCDEFs world-class controls (an $89 value) free 

Our Price $249 (STOOLCWG) 

CodeWarrior Gold (C/C++ & Pascal, 68K & PPG) 

Our Price $199 (STOOLCWB) 

CodeWarrior Bronze (C/C-i-i- & Pascal, 68K) 

Our Price $199(ST00lsymt) 

Symantec (THINK) C/C+-I- and THINK Pascal (68K) 

Our Price $149 (STOOLSYM) Symantec aHINK) C/C-r+ {68K) 
Our Price $149 (STOOLPAS) THINK Pascal (68K) 

•CodeWarrior required to write plug-ins 


VVA*^*** - 
the'*®? 




Here’s a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 

Discover Programming for Mac 

SCWDISCMAC 

99.00 

79.00 

Discover Programming With Java 

SCWDISCJAVA 

99,00 

79.00 

LPA MacProlog Developers Edition 

SLPAD 

1500,00 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

745.00 

495.00 

Mac FORTRAN II 

SF0RT2 

595.00 

549.00 

Power MachTen-UNIX 

SM10PPC 

695,00 

695.00 

Presenting Magic Cap 

BPRESMAGiC 

16.95 

15.25 

Professional Mach Ten for 68k Macs 

SPR0M10 

695.00 

695.00 

SmalltalkAgents 

SSTA 

695,00 

695.00 

Symantec C-n- for 68k 

SSYMCPP68K 

299.00 

349.00 

Symantec C-n- 8.5 

SSYMCPP 

499.00 

349.00 

Think Pascal Version 4.0 

SPASCAL 

199,00 

165.00 
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• Full product descriptions • Hundreds of more products 
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Symantec Visual Cafe 

by Symantec Corporation 

Symantec Visual Cafe for Macintosh or Windows gives developers the 
fastest, most productive visual programming environment ever for 
creating Java applets and applications 

• Drag and drop visual programming, easy to learn and use 

• Flexible development environment, two-way programming 

• Comprehensive component library, create re-usable templates 

• Extensive Java toolset and the fastest compilers 

Our Price $199 (SVCAFEMAC) 

OR Our Price $199 PVCAFEWIN) 


OOFILE Reporter Writer 

by A.D. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text. KTML or FtTF 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean object-oriented design 

• Incudes RAM-based version of OORLE database. Included in full 
OOFILE Platform Bundle 

• Saving to file without preview of printing is cross-platfonn-ain on 
your Mac/Win/Unix server and creates 

web pages 

• Price includes 1-year subscription 
Our Price $500 (SOORW) 


PowerBuilder Desktop for Mac 

by Powersoft 

• Ctient/Server & Internet Development Tool 

• Increases productivity for individual developers 

• Point-and-click DataWindow 

• Fast complied code, ODBC connectivity to desktop databases 

• Anywhere DBMS, create powerful Win, Mac. and Internet apps 

Our Price $295 (SP8DFM) 



ObjectSet Mail SDK 
for Macintosh 

by Smartcode Software 

• Provirtes easy-to-use MIME, 

SMTP & POPS APIs 

• Royalty-free C-r-r classes for 68k 
and Power Macintosh 

• Compatible with ALL leading e-mail products 
Ideal for use in Internet and Intranet environments 
Samples with documented, reusable source code 
Windows, UNIX, and multi-platform versions available 


Our Price $495 (SOSMSOK) 



BBEdit4.0 

by Bare Bones Software 

A powerful, easy-to-leam text editor. Adds 
new features for HTML coders, including a 
spelling checker and HTML tag palette. 
Accelerated tor Power Macintosh; dragging 
supported everywhere; Internet Config 
aware; PowerTalk aware. Integrated support 
for Symantec’s IDE, Metrowerks 


CodeWarrior, THINK Reference 2.x, MPW 
ToolServer. and most other environments. 
Many UNIX style tools, including ‘grep" 
searches, file comparisons, and sorting 
multi-tile search and replace. 

PopUpFuncs feature lets you jump to a 
function from a menu. 

List Price $119 Our price $94 (SBBEDIT) 
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FaceSpan v2.1 

by Digital Technology International 

• Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

• Develop quick prototypes, print multiple 
pages with sophisticated layouts 

• Script essential elements of ttie FaceSpan 
application - Enhanced save options 

• Play and record sounds as either "snd" resources or as “AIF" files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for implementing timed behaviors 
- New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to low-memory situations-lncreased support 
for Frontier UserTalk! 

List Price $299 Our Price $279 (SFACESPAN) 

TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP™ commands in AppleScript^'^ 

• Send e-mail or files through a script, 
check if users are logged on (via Finger), 

automate FTP, Gopher, NetNews, Telnet, and LPR, verify links in 
FfTML documents, and quickly write many other TCP/IP client- 
server programs 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
Our Price $49 (STOP) 

WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Rea) "Macintosh" user-interfaces 
right inside HyperCard. Until now you either created HyperCard 
stacks or Macintosh applications. With WindowScript you can iiterally 
bring the look and feel of a real Macintosh user-interface to 
HyperCard, if you're a HyperCard developer, interface designer, 
application developer, program manager or tester searching for a 
prototyping tool, WindowScript is perfect for the job. 

Our Price $149 (SWSCRIPTl 


ii\ 


# 


TCPilP 

Scripting Addition" 

rhi-misrtie( Sofl^Uiin 



Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get Lie most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
bre^points 

• Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 

List Price $129 Our Price $119 (SOEBUG) 

Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice, Scripter! 

• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map, associated terminotogy 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• ScriptBase is now included; stores your data and media elements 
(frequently used values, text, pictures, scripts, HTML, headers, file 
references) and share them between scripts all with a special 
new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don't write scripts without it! 

List Price $199 Our Price $179 (SCRIPTER) 

AppleScript Finder 
Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 

record, or run scripts that trigger the same desktop acbons that you 

trigger using the keyboard and mouse. 

List Price $19.95 Our Price $17.95 (BAFG) 





Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 

DogPatch 

SDOGPATCH 

299.00 

199.00 

PreFab Player 

SPLAYER 

95.00 

95.00 

ScriptBase 

SSCPTBASE 

59.00 

59.00 

SoriptWizard 

SWIZ 

89,00 

84.95 

Tenon Ported Applications CD 

SPORTED 

50,00 

49.95 
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Legtop Podeum 

by Rach Inc. 

A combination working 
platform and carrying case 
that allows laptop owners a 
safe and comfortable way 
to use their computer in a variety 
of mobile and field environments. 
• Straps to your leg for mobility! 

Our Price $79.95 (ALGPPOO) 



CronManager 

by Orchard Software 



• Implements the UNIX Cron facility 

• Open any Macintosh file on a given date and time 

• Simple interface 

• Works with any Macintosh file 

• Cron Manager bundled with CUmate 

Our Price $26.95 (SCRONMGR) 


CPU Doubler 

by Orchard Software 

• Performance enhancement 
utility for the Macintosh 

• Increases the speed of 
your computer by 100% 

• Works on both the PowerPC 
and 68K Macintosh 

• Manages computer 
throughput using a proprietary scheduling algorithm 

• Ensure optimal performance and compatibility 
Our Price $79.95 {SCPU2X} 

SEE RELATED PRODUCTS; Development Environments 
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NeoAccess 

by Neologic 

• Full-featured object database engine for use in Macintosh, 
Windows, Unix and DOS based C++ applicalions 

• Extended binary trees and binary search algorithms tuned fa 
short aosiss times; dynamically camhined, collapsed, and 
compressed indices; object caching for instant aa'ess to 
previously used objects 

• Build fest, powerful applications in record time! 

Our Price $749 (SNEO) 


Check out our Web site! 

Full product desolptlons • Hundreds of more products 

http://www.devdepot.com 


c-tree Plus'^ Database Handler 

by Faircom 

Unsurpassed 
Cross Platform 
Tools for Mac 
Developers! 

• Full C Source 

• Client/server 
Option 

• Over 16 years proven reliability 

• Concurrent simultaneous access of Mac/PC files 

• Superior throughput and performance 

• Unparalleled scalability and flexibility 

• Fixed/Variable length files 

Our Price $895 (SCTPDH) 



r-tree Report Generator 


by Faircom 

Handles virtually every aspect of 
report generation: 

• Complete 0 source 

• Complex multi-line reports 

• Multf-flie access 

• Complete layout control 

• Conditional page breaks 

• Nested Headers and Footers 

• Horizontal Repeats 

Our Price $445 (SRTRG) 





Guide Composer" 1.2 STEP^** 

by StepUp Software SOFTWARE 

• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment; Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will USB them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases. Coach marks, Fully-integrated with Apple's 
Guide Maker (distributed with Guide Composer), 

compiles scripts automatically, PICTs in Panels, Generated Guide 
scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www,guideworks.cDmy 

Our Price $99 (SGCOMP) 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGiiide Slarler Kil, Real World AppleGuide 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Smooth integration with Metrowerks CodeWarrior IDE 

• Support of ^pleEvents and ^pleScript 

• Comparison of files of different types (not only text files) 

• Configurable local file locking (Finder flag or ckid resource) 

• Improve handling of local files includeing the creation of folder 
structures 

• Significant performance improvements in many places 

• Essential parts PowerPC native 

• Version control tool for the simple and clear management of 
projects in which files 

are created in numerous versions (variants and revisions) 

• Allows both variant and revision control, and it manages not only 
variants and revsions of single files, but of a whole software 
project (multi files, multi users, multi-variants, access rights, etc.) 

• Graphical user interlace and is not only suitable for mere source 
code control but c<^ handle all different kinds of files with amazing 
compression rates: typical size of delta between arbitrary files 5% 

• Please note special prices for multiple copies: 

Single license $229 {SV00D001); 2 pack $359 (SVO0D002); 
5 pack $799 (SV00D0O5); 10 pack $1369 (SVOODOO10); 

20 pack $2399 (SVOODOO20) 

Addiliofial pricing available on request, 

SEE RELATED CATEGORY: Dev. Environmenls 


StoneTable 68K/PPC 

by StoneTablet Publishing 

• StoneTable is a replacement for the Macintosh List Manager 

• Available for use with Think C, MPW C & Pascal, CodeWarrior C 
and Pascal 

• Includes libraries tor 68K and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlarrt environment 

Our Price $200 (SSTONEFAT) 


about 

purchafR 




Compilelt! 

by Royal Software, Inc. 

Compilelt!, the first HyperTalk compiler, is a complete developement 
system for the creation of XCMDs and XFCNs. 

• Exfiand the capabilities of your environment by using Compilelt! 
and the ROM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts intooexternals 

• Protect sensative code from prying eyes because your code is 
now complied I 

• Easily learn Macintosh programming by exploring the ROM Toolbox 

• Includes Debugltl, a valuable source-level debugger for externals 
created with Compilelt! 

Our Price $149 (SCOMPIT) 


QC 

by Onyx Technology 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, handle/pointer 
valiriation, dispose/reiease checks, write to zero, de-reference 
zero as well as ottier tests like free memory invalidation and 
bixk bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 

List Price $99 Our price $94.99 (SOC) 


MacA&D 6.0 

by Excel Software 

MacA&D combines tlie capabilities of MacAnalyst plus additional 
detailed design, code generation and code browsing features into 
one integrated applicallon. It automates structured analysis and 
design, object-oriented analysis and design, state modeling, task 
design, data and screen modeling, code editing and browsing, 
reengineering, requirement traceability and a 
multi-user data dictionary, It generates SQL from data models, C++ 
or Object 

Pascal from class diagrams and C, Pascal, Basic or Fortran code 
from 

structure charts, 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design 

• Data and screen modeling 

• Integrated code editing and browsing 

• Mulii-user dictionary and requirements 

• Code to design diagrams for C, C-i-i-, etc. 

• Design diagrams to code for C, C-i-f, etc. 

• State modeling diagrams and tables 

• Use cases with traceability 

List Price $1995 (SMACADP) 
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SoftPolish CD-ROM 

by Bare Bones Software 

• Tfie essential tool for software quality assurance on ttie Macintosh 

• Helps you identify inconsistencies with Apple’s user interface guidelines, 
misspelled words, missing resources, and other mistakes 

• Provides tools to put the finisfling touches on software dislrSiution 
packages prior to retease 

• Works independentiy of any programming ianguage or environment 

• Ideal for sanity checking software throughout the development process 

List Price $99 Our price $89 (SSOFTPOL) 


Spellswell Plus 2.0.4 

by Working Software 

• Award-winning, comprehensive, practical spelling checker that 
works in batch mode or witliin applications ttiat incorporate ttie 
Apple Events Word Services protocol (e.g., Eudora. WordPerfect, 
Communicate!, and InfoDepot) 

• Checks for srielling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

• MacTech orders include developer kit with Writeswell Jr., a sample 
AppleEvents Word Services word processor and its source code 

• Available tor OEM Sales 

Our Price $74.95 (SSPELL) 


B-Tree HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Rods keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 

Our Price $150 (SBTBEE) 




Future Basic II 

by Staz Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming. 

Source level debugger and Interactive compiler/editor 
Multi-file Project manager and Multi-file find and replace 
Super fast compilation, 32 bit clean, and System 7.x savvy 
QuickBASIC converter 

Getting Started manual with over 500 example tiles 
Full support of standard BASIC 

Our Price $229 (SFBASIC2) 


by dtF Americas 


• True relational databa% system for Apple Macintosh computers 

• Provides a powerful choice for developers who want to create 
database centered applications with no performance trade-offs 

• Features SQL. full transaction control, error recovery, single user, 
client server architecture and multi-platform support including 
DOS, Windows, OS/2 and UNIX 

• Ttie C/C-n- API is identical and fully portable across all supported 
platforms 

• I hird-party vendors supporting dtF will be able to offer a variety of 
advanced features and benefits to ttieir customers royalty tree 

• Tools are included for importing, exporting, creating and managing 
databases and users 

• Supported development environments include: Symantec. MPW. 
Metrowerks and more Mac/SDK 

List Price $695 Our Price $679 (SDTF) 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer “atoms” that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 

Our Price $219 (SINSTALL) 

ScrIptGen Pro 

by SlepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstalierPack, Stuffit decompression. Compact 
Pro decompression, custom packages, splash screens, network 
installs, anti resource installation 

Our Price $169 (SSCRPTGEN) 



Web site: http://www.devdepot.corn • E-mail: orders@devdepot.com 
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Tesfiyack-Bug 'hracking the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful fitter mechanism, and 
multiple reports 

• Links your testers, engineers, documentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supporte single- and multi-user bug databases (additional licenses 
required to use multi-user features) 

Our Price $129 (STETR) 

MacFlow'”: Flowchart 
Design and Development 

by Mainstay 

Use MacFlow™ 4.0 for Macintosh to 
produce top-quality diagrams fast, 
without tedious drawing. Present your 
company’s organizational structure or 
design and document the flow of a manufacturing process. Develop 
any overall view of work, project, or logic flow in just minutes! No 
other flowcharting method offers the ease-cf-use, speed, and 
outstanding flexibility of MacFlow for Macintosh, 

• Create Quality Flowcharts — Fast 

• Intelligent Symbols Make Flowcharting — Easy 

• Turn Outlines Into Flowcharts — Automatically 

• Customize Line and Arrowhead Styles 

• Expand Functionality Using Plug-In Modules 

• Link Nested Charts, Comments, and Files 

• Share Ctiarts Electronically — royalty-free! 

List Price $179 (SMACFLO) 



AppMaker 

by Bowers Development 

• Develop the user interface for a 
Macintosh application using the 
original interface builder 

• Just point and click to design your 
application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments including Metrowerks, Symantec, or MPW; C, C-ir-i-, 
or Pascal; procedural or object-oriented, using PowerPlant, TCL, or 
MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh 
Toolbox programming techniques 

• Includes one-year subscription on CD and hardcopy documentation 
List Price $299 Our Price $199 (SAPPMAKE) 



Plan & Tl'ack Project 
Planning and 
Management 

by Mainstay 

Plan & Track™ 3.5, for Macintosh helps 
you plan and manage any project. With 
Plan & Track, you can create a project plan minutes after opening 
the package. There's no faster or easier way to keep things on track 
and within budget tlian with Plan & Track. 

• Direct Approach to Project Planning: Quickly plan projects, events, 
and campaigns 

• Create Presentation-Quality Project Plans: Quality, full-color 
charts or layouts. Integrated Spreadsheet and Graphing 

• Automatic Calendar Management; Plan & Track automatically 
creates and manages, Multipie-Page Schedules 

• Earned Value Analysis: Offers a simple method of relating value, 
cost, and progress 

• Drag-and-Drop Support, Standard and User-Defined Symbols 
and Task Bar Styles 

List Price $179 (SPLNTRK) 




Phyla"; Object-Oriented Database 

by Mainstay 

• Powerful Databases Without Programming: Phyla handies your all your complex database needs 

• Define a Database in Minutes; Using an intuitive, graphical user interface 

• Objects Are a More Natural Approach: Phyla creates real world databases 

• Drag-and-Drop Ease; Relate objects by simply dragging objects between windows 

• Create Custom Forms and Reports: Quickly create custom forms and reports 

• Fast Finds and Sorts; Perform complex queries and calculations without programming 

• Synchronize Multiple Databases Copies 

• Password Protection With Access Limitations 

• Easy Import and Export; Import from other databases, export data in various formats 
List Price $179 (SPHYLA) 


16 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 

































VText 

by Vivistar 

VText is a C++ add on library for 
Metrowerks' PowerPlant 
application framework. VText 
provides complete Macintosh text 
support including: greater than 
32kb text, undo, drag and drop 
editing, AppleEvent scripting and 
recordability, full support for 
muitibyte characters and inline 
input methods including Japanese 
and Chinese text, and full support for bi-directional script systems 
including Arabic and I lebrew, 

• Full featured text engine for Metrowerks’ PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible otiject oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript savvy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored for scriptability and recordability 
Our Price $350 (SVTEXT) 



LiveAccess™ 1 User Edition 

by dtp Americas 

Suite of OpenDoc’''^ parts for accessing relational database 
systems. 

• Compatible with FileMaker Pro, 4th Dimension, Oracle? and ODBC 
List Price $69 (SLAUE) 

LiveAccess"* 1 Developer Edition 

by dtp Americas 

Suite of OpenDoc’T^^ parts for accessing relational database systems 

• Includes the User Edition plus IDL-files to extend the LiveAccess 
parts suite 

• Compatible with FileMaker Pro, 4th Dimension, Oracle? and ODBC 
List Price $99 (SLADE) 


OpenGL for 
the Macintosh 

by Conix Graphics 



• Powerful 3D graptiics library, 100% OpetiGI compliant 

• Portable to more ptatfomis than any other API 

• Delivers workstation-class performance to the Mac 

• RAVE hartfware supfiort gives you the speed you need 

• Multi-processor capability & works with ALL compilers 
Our Price $279 ^OPENGL) 



DesignWorks 4.0 

by Capilano Computing 

DesignWorl^ 4.0 has all the ease of use and schematic editing power 
of previous versions, plus new features designed to make your entire 
design process easier and more error free. The 4.0 version has new 
menucustomi^ation and scripting features that will directly address 
your designchecking and Interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels is fully supported 

• Powerful attribute features allow arbitrary text information to be 
associated witti any signal, device or device pin 

• Extensive symbol libraries with over 12,000 parts in ANSI and IEEE 
format 

• Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simulator option is available. No netlists, no 
application switching! 

List Price $995 (SDWORKS) 



CGi Toolkit 

by Pictorius Inc. 

The Pictorius CGi Toolkit is the fast and easy 
route to tiigh performance CGIs and ACGIs for 
your Mac Web site. 

•Interactively develop CGIs while the web 
server, the CGI Toolkit and the browser are 
running on the same machine 
Interactively develop, test and debug CGIs before compiling 
Powerful debugger allows you to edit code, roll back, code and 
change input values while your application is running 
Fully object oriented so you can re-use your code 
Automatic handling at Apple Events so you can concentrate 
on building functionality 

Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
List Price $149 (SCGITLKT) 
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• The pragrammer’s text editor that 
defined the industry standard for 
speed and efficiency 

• PowerPC native 

• Features integrated support few 
Symantec C/C++, Metrowerks 
CodeWarrior 6, and MPW 

• Supports aii the major development environments on the Macintosh, 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable cliptxiards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non-contiguous selection 

• Includes Celeslin Company's APPRENTICE 4 


QUED/M 3.0 

by Nisus Software 


List Price $149 Our Price $89 (SQUEOM) 


Check out our Web site! 

Full product descriptions • Hundreds of more products 

http;//www.devdepot.com 


Bee>one 

by Power Box 

8ee-one lightens your load on the road by 
adapting relational databases developed 
under 4D“ to the Newton Platform. Once 
the program is installed on both the 
Macintosh and the Newton, it takes 4 
simple steps to use Bee-one! 

• Database transfer, Set-up, Use, and 
Synchronization 

Our Price $139 (SBEEONE) 


kw^dUCT! 



Order Toll-free 
800-MACDEV-1 


18006223381 ] 








Here are more products. For full product descriptions please 

see our Web 

vMor.! 

site, or feel free to call, fax, 

or E-mail us. 





PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 



Animation Class Library 

SACL 

250,00 

250.00 



CLlmate 

SCLIMATE 

59,95 

59.95 



CMaster 

SCMASTER 

129,95 

129.95 



DataScript 

SWDSCRIPT 

249,00 

229.99 



ICONIX PowerTnols-10 Pack 

SICPP10 

7,995,00 

7 , 845.00 



ICONIX PowerTools-6 Pack 

SICPP6 

5,995,00 

5 , 945.00 



ICONIX PowerTools-8 Padt 

SiCPP8 

6,995,00 

6 , 945.00 



ICONIX PowerTools-AdaFlow 

SICADA 

1,495.00 

1 , 395.00 



ICONIX PowerTools-ASCII Bridge 

SICASCII 

1,495.00 

1 , 395.00 



ICONIX PowerTools-CoCoPro 

SICCOCO 

1,495.00 

1 , 395.00 



ICONIX PowerTools-DataModcler 

SICDATAMOD 

1,495.00 

1 , 395.00 



ICONIX PowerTools-FastTask 

SiCFASTTASK 

1,495.00 

1 , 395,00 



ICONIX PowerTools-FreeFlow 

SICFREEFL 

1,495,00 

1 , 395,00 



ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,495,00 

1 , 395,00 



ICONIX PowerToois-PowerPDL 

SICPOWER 

1,495,00 

1 , 395.00 



ICONIX PoworTools-QuickChart 

SICOUICKCH 

1,495,00 

1 , 395,00 



ICONIX PowerTools-SmartChart 

SICSMART 

1,495,00 

1 , 395.00 



ICONiX Training & Consulting 

TICONIX 

3,000.00 

2 , 945.00 



IMSL Math and Stat F77 

SIMSLSTAT 

495.00 

495.00 



Info-Mac X 

SINFOMAC10 

39.95 

35.95 



LJ Profiler 

SLJPROF 

295.00 

295.00 



Mac Source II 

SMACSOURCE 

29,95 

26.95 



MacA&D 6,0 

SMACADP 

2,995,00 

1 , 995.00 



MachTen Code Builder 

SM10C0DEB 

149,00 

149.00 



Macintosh Common LISP 4,0 

SMCLISP 

725.00 

725.00 



Spellswell Plus 2.0,4 

SSPELL 

74.95 

74.95 



Spyer 

SSPY 

39.00 

39.00 
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Casino! 

by BeachWare, Inc. 

Can‘l make il lo Vegas this monlh? Your 
best bet is Casino! Whether your favorite is 
Slots, Poker, Blackjack, or Keno, this virtual 
casino will entertain you for hours witfi its 
ten different machines. Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM. PC system 
re(}uirernents: Windows 3.1 or later, CD-ROM drive, 4 MB of RAM. 

Our Price $24.95 (SCAS) 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics. Ten games, including Moon Lander, 
Astro-Boing, Hyper Hockey, Ballistic Avenger, and more. System 
Requirements: Mac - Color Mao wiUi 8 MB RAM, CD ROM drive. PC 
- 486 with 8 MB RAM, Sound card, SuperVGA,CD-ROM drive. 

Our Price $29.95 (SOLA) 





Night Sky Interactive 

by BeachWare, Inc. 

Introducing a new PC/Mac infroductory astronomy 
learning experience on CD-ROM. Constellations, 
comets, stars, planets, meteors, galaxies, the moon 
and more are yours to explore in this CD. Watch 
animations and hear narratives about how the moon 
orbits the earth and many other topics. Mac System requirements: 
Color Mac, CD-ROM drive, 4 MB ot RAM, PC system requirements: 
Windows 3.1 or later, CD-ROM drive, 4 MB RAM, 

Our Price $24.95 (SNSI) 


MultiWare 

Multimedia Collection 

by BeachWare, Inc. ^ 

Introducing a new Audio multimedia music i 

CD-ROM for the Macintosh. This disc is a ' 
collection of clips ideal for Desktop ' 

Presentations and otfier Multimedia applications. This incredible 
collection of license-free media clips is bursting with 240-r color 
pictures and backdrops (PICT), 200+ sound & music clips (SoundEdit), 
140+ QuickTime movies, and a variety of muitimedia tools for use with i 
the Macintosh. ; 

Our Price $24.95 (SMWMC) 

SEE RELATCO CATEGORY: Multimedia i 



1000 Games for 
Macintosh 

by BeachWare, Inc, 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and 
public domain programs. Battle ugly aliens, blast apart run-away 
asteroids, deal yourself that royal flush or solve that 3-D puzzle, this 
disc lias it alt! System requirements: Mac Plus or greater, CD-ROM 
drive, and 2 MB of available RAM (4 MB of RAM when running under 
System 7), 

Our Price $17.95 (STGM) 




A Ziilion Sounds 

by BeachWare, Inc. 

An incredible PC and Macintosh sound effects 
CD-ROM containing 2,177 separate sound 
effects and short music clips. Each sound is 
conveniently stored in both SoundEdit and 
System 7 Beep Sound formats for Macintosh and WAV format for 
Microsoft Windows. All of the sounds are conveniently organized in 
separate categories. Mac System requirements; Any Mac, CD-ROM 
drive, 1 MB of RAM. PC system requirements: Windows 3.1 or later, 
CD-ROM drive, sound card. 

Our Price $24.95 (SAZS) 



Multimedia Nursery Rhymes 

by BeachWare, Inc. 

Introducing a magical new PC/Mac playing and 
learning experience on CD-ROM. This disc 
contains forty Nursery Rtiymes, ten of whiofi 
include on-screen fingerplays! Each rhyme has its 
own screen with original artwork, wonderful 
animation, fun sound effects, and great songs. Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM, PC system 
requirements: Windows 3.1 or later, CD-ROM drive, 4 MB of RAM, 

Our Price $24.95 (SMNR) 


Goldilocks Gamebook 

by BeachWare, Inc. 

Introducing a beautifully illustrated & 
animated, interactive version of the 
classic Goldilocks and Ihe Three Bears 
story, This PC and Macintosh CD-ROM 
presents the Goldilocks story in over 30 
interactive screens. Throughout the story you can also choose to 
play one of ihe seventeen separate games that relate to specific 
Kenes and encounters. 

Our Price $24.95 (5GGB) 



f? 
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Check out our Web site! 


• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



Music Tracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more, This collection offers you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-freel! Mac System requirements: Mac Plus or 
greater, CD-ROM drive, PC system requirements; Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 


Our Price $24.95 (SMT) 


Trivia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand trivia 
questions, in 45 categories, in several 
game formats! Test your memory with the 
QSA, Concenlratioti, and Multiple Choice 
games! Categories include; Animals, 

Bodies, Bond, Bugs, Cities, Comics, Geography, Gilligan, Gross, 
Health, Holidays, Horrors, Kids, Knot's Landing, Math, Movies, and 
many more, Mac System requirements: Color Mac, CD-ROM drive, 4 
MB of RAM, PC system requirements; Windows 3,1 or later, CD- 
ROM drive, 4 MB of RAM. 

Our Price $24.95 (STW2K) 



Screen Machine 

by BeachWare, Inc. 

Personalize your computer screen 
with this dynamic and useful collection of 
Screensavers and Wallpapers, Choose from 
over 100 original Screensavers such as 
flying airplanes, bouncing coffee cups, 
falling climbing gear, shifting psychedelic patterns, or floating 
spaceships. Customize your computer desktop with over 150 exciting 
new wallpapers such as sand, rocks, cloth, coins, cartoons, or 
unique pallerns. Included is an easy to use browser program that 
lets you sample ail of the Screensavers and Wallpapers before 
installing them on your computer. 



Our Price $24.95 (SSM) 


Web Ware 

by BeachWare, Inc, 

The ultimate collection of clip media and 
templates for building your own Web Page. 
An incredible selection of Shockwave 
movies, animated GIFs, buttons, bullets, 
dividers, and sample HTML pages. There 
are literally thousands of graphical elements on this disc, all there to 
spice up your web page. In all, it's about 300 megabytes of 
creativity only a mouse-click awayl System Requirements: PC - 486 
or better with 8 MB RAM , Sound card, SuperVGA, CD-ROM drive. 
Macintosh - Color Mac with 8 MB RAM, CD-ROM drive. 

Our Price $24.95 (SWEBW) 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

3D Game Machine 

S3DGAME 

$ 299.00 

Digital Swimsuit Portfolio 

SDSP 

24.95 

Do It Youseif Credit Repair 

SCR 

24.95 

Nature Photos 

SNP 

24.95 

Photo Textures 

SPT 

24.95 

Religion Bookshelf 

SRB 

24.95 

Vitamin 

SVITAMIN 

24.95 

World War II Almanac 

SWW2A 

24.95 
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Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. Includes: QuickDraw™ GX 
Library, Macintosh Human Interface Guidelines, PowerPC Sjstem 
Software. Macintosh Toolbox Essentials and More Macintosh Toolbox, 
QuickTime and QuickTime Components. Access over 16,000 pages of 
information with Hypertext linking and extensive cross referencing. 

List Price $99.95 Our Price $89.95 (BIMCD) 






a Here are all of the Inside Macintosh products -10 % off! For full nroduct 

1 i descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


^ PRODUCT 

CODE 

LIST PRICE 

OUR PRII 


Inside Macintosh: AOCE Applications Interface 

BIMAOCE 

$44.95 

$40.45 


Inside Macintosh; AOCE Service Module 

BIMAOCES 

29.95 

26.95 


Inside Macintosh; Devices 

BIMDEV 

29.95 

26.95 


Inside Macintosh: Files 

BIMFIL 

29.95 

26.95 


Inside Macintosh; Imaging with QuickDraw 

BIMIMAG 

32.95 

29.65 


Inside Macintosh; Interapplication Communications 

BIMIAPP 

36.95 

33.25 


Inside Macintosh; Macintosh Toolbox Essentials 

BIMTBOX 

39.95 

35.95 


Inside Macintosh; Memory 

BIMMEM 

24.95 

22.45 


Inside Macintosh: More Macintosh Toolbox 

BIMMAC 

34.95 

31.45 


Inside Macintosh: Networking 

BIMNET 

29.95 

26.95 


Inside Macintosh: Operating System Utilities 

BIMOPSU 

28.95 

26.05 


Inside Macintosh: Overview 

BIMOVER 

24.95 

22.45 


Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

28.95 

26.05 


Inside Macintosh: PowerPC System Software 

BIMPPCSYS 

24.95 

22.45 


Inside Macintosh; Processes 

BIMPROC 

22.95 

20.65 


Inside Macintosh: QuickDraw GX Environ. & Utilities 

BIMGXENV 

31.95 

28.75 


Inside Macintosh: QuickDraw GX Graphics 

8IMGXGR 

31.95 

28.75 


Inside Macintosh; QuickDraw GX Objects 

BIM6X0BJ 

31.95 

28.75 


Inside Macintosh: QuickDraw GX Printing 

BIMGXPRNT 

29.95 

26.95 


Inside Macintosh; QuickDraw GX Printing Extensions 

BIM6XEXT 

29.95 

26.95 


Inside Macintosh; QuickDraw (aX Prog. Overview 

8IMGX0V 

24.95 

22.45 


Inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

29.95 

26.95 


Inside Macintosh: QuickTime 

BIMQT 

29.95 

26.95 


Inside Macintosh: QuickTime Components 

BIMQTCOM 

34.95 

31.45 


Inside Macintosh; Sound 

BIMSOUND 

29.95 

26.95 


Inside Macintosh: Text 

BIMTEXT 

39.95 

35.95 


Inside Macintosh: X-Reference 

BIMXREF 

19.95 

17.95 


(Book sale prices are contingent upon availability) 
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Danny Goodman’s Apple 
Guide Starter Kit 

by Danny Goodman 
and Jeremy Joan Hewes 

Create your own Apple Guide databases quickly 
and easily, without having to learn a scripting 
language, write coded tiles, or use several 
different files and programs. Includes advice 
and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing, Book/disk, 320 pages. 

List Price $34.95 Our Price $31.46 (BDGAGSK) 

Essential OpenDoc 

by Jesse Feiler and Anthony Meadow 

Gives an in-depth look at the technical Issues of OpenDoc. Explores 
the three core technologies that support it's functionality - SOM, 
OpenDoc's storage mechanism, and the Open Scripting Architecture 
(OSA), Also examines CyberDog, a set of OpenDoc part editors that 
provides access to Internet services and offers compelling example 
of the power of OpenDoc development. 

List Price $38.95 Our price $35.95 (BESOD) 

Mac OS 8 Revealed 

by Tony Francis 

The first authoritative look at this exciting 
new operating system. A must for Mac 
developers who want to make their 
software compatible with Mac OS 8. 

Essential for system administrators who 
plan to upgrade their system. Included 
CD-ROM contains demos of new Mac OS 8 features. 

List Price $34.95 Our Price: $31.45 (BMACOSSR) 



^Edit 

Complete 


ResEdit Complete, 

Second Edition 

by Peter Alley 
and Carolyn Strange 

Customize every aspect of your interface 
form creating screen backgrounds and icons 
to customizing menus and dialog boxes. 
Book/disk package, 608 pages, 


List Price $34.95 Our Price $31.45 (BRESED2) 



B Apple Guide 
_Complete! 




AppleGuide Complete 

by Apple Computer, Inc. 

Covers Guide Maker, the 
software you use to build §n 
and test guide files, 

Leam about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 
files. Book/CD-ROM, 544 pages. 

List Price $39.95 Our Price $35.96 (BAPLGD) 

SEE RELATED CATEGORY: Tools, Libs & Utilities 

OpenDoc Programmer’s Guide 

by Apple Computer, Inc. 

The official reference for the implementation of OpenDoc on the Mac 
OS. Describes the component software revoluflon and explains how to 
develop for it on the Mac OS platform. Accompanying CD-ROM 
contains a complete reference to toe OpenDoc programming 
interlace, and an extensive collection of tested, reusable sample code. 

List Price $44.95 Our Price $40.46 (BOPENDOQ 

OpenDoc Programmer’s Cookbook 

by Apple Computer, Inc. 

Shows you how to create OpenDoc software 
components, called parts editors, for the Mac OS 
Platform, Including instructions for setting up toe 
Macintosh Programmers Workshop (MPW) 
development environment to write OpenDoc 
software. Annotated listings of explaining toe 
methods that implement the SamptePart part 
editor. Descriptions of other sample part editors created by the 
OpenDoc engineering team to illustrate more advanced features. An 
Introduction to the System Object Model (SOM) technology 
underlying OpenDoc. 

List Price $24.95 Our price $22.45 (BOOCOOK) 




The ResEdit All Night Diner _ 

by David Ciskowski "■ 

An idea-filled menu and introduction to the joys of customizing 
software. Add personality to the Mac by customizing default icons, 
the text of menus and dialog boxes, cursors, pointers and more. Disk 
features ResEdit, plus lots of sample resources, 

List Price $24.95 Our Price $22.45 (BRESDiNE) 

SEE RELATED CATEGORY: Dev. Environments 


Here are some popular books for the NEXTSTEP enthusiast - 10% off ! 

RODUCT CODE LIST PRICE OUR PRICE 

NEXTSTEP Development Tools & Techniques BNEXTDTT $30,95 $27.85 

NEXTSTEP General Reference BNEXTGR 44.95 40.45 

NEXTSTEP Programming Interface Summary BNEXTPiS 30.95 27.85 

NEXTSTEP User Interface Guidelines BNEXTUIG 24.95 22.45 
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PowerPC 

PowerPC Programmer’s 

Toolkit 

OPTIMIZING 

Programmer's 

by Tom Thompson 

CODE 

Toolkit 

CD-ROM Includes a special version of 

T4i|l difJnkllvi 

CviOjilii^ iai» Itti 

Metrowerks CodeWarrior 7.0 and sample 



code from the book. Details how to write 



PowerPC applications in native code for 



blazing speed. Written by an Apple Insider. 





List Price $45 Our Price $40.50 (SPPCPT) 

Network Frontiers Bundle 

byAP PROFESSIONAL 

includes 3 books: 

Complete Guide to MAC,Backup Management, Designing AppleTalk 
Network Architectures, and Managing AppleShare and Workgroup 
Servers Apple Certified. Each bundle includes the first 3 books that 
correspond to the Apple Certified Server Engineer (ACSE) program, 

List Price $89.95 Our Price $59.95 (BNETFB) 

Tog on Software Design 

by Bruce “Tog” Tognazzini 

Respected industry futurist. Tog, presents his 
vision of our technological future, detailing 
the steps computer professionals need to 
take to deliver new technologies that will 
profit the industry and benefit society in 
general. Contains Tog's insights on a wide 
range of topics from quality management to 
ttie meaning of standards. 

List Price $29,95 Our Price $26.95 (BTOG) 

Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
byAddison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

List Price $99.95 Our Price $89.95 (STBASST) 

A Fragment of 
Your Imagination 

by Joe Zobkiw 

Packed with useful code fragments for 
the Macintosh and Power Macintosh. 

Hard to find information about techniques 
used to structure and build fat, safe fat, 
and accelerated code resources, All code 
is reusable and is provided on the disc, 
along with Metrowerks Code Warrior Lite. Book/CD-ROM, 528 pages. 

List Price $39.95 Our Price $35.96 (BFRAG) 





Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

Ust Price $39.95 Our Price $35.96 (BOPTPPC) 
Macintosh Programming Secrets 2nd edition 

by Scott Knaster and Keith Rollin 

Macintosh Programming Secrets is divided in two parts 
Part 1: “Concepts and Ideas." Discusses the evolution of the 
Macintosh and the standards, customs, and software that shape the 
system as well as the Macintosh user interface, 

Part Z: “Technical Adventures," Presents the skeleton of an 
application, and then builds upon that framework to describe how to: 
Create fancy dialogue boxes. Utilize the new 32 bit QuickDraw 
developments. Track the mouse with “marching ants". 

List Price $31.95 Our Price $28.76 (BPSECRETl 


n eludes 
DiskI 


BASIC for the Newton 

by John Schettino & Liz O’Hara 

Program on Macintosh, Windows-based PC, or on 
the Newton itself. Straight-forward “programming by 
example" approach - you'll be writing Newton programs right away. 
Includes 3.5" disk containing Demonstration NS BASIC and over fifty 
example programs (Newton not included). 

List Price $35.95 Our Price $32.35 (BNEWT) 

SEE RELATED CATTGORV: Dev, Environments 


Programming for the Newton: 
Software Development using 
^ NewtonScript 

Newtxon by Julie McKeehan and Neil Rhodes. 

Foreword by Walter R. Smith 

An indispensable tool for Newton programmers. Includes disk with 
sample Newton application from the books, as well as 
demonstration version of Newton Toolkit (NTK) - the complete 
development environment for the Newton®, A Publication of AP 
Professional May 1994, Softcover, 393 pages. 

List Price $29,95 Our Price $26.96 (BPROGNEWT) 

SEE RELATED CATEGORY: Dev. Environments 

Programming with AppleTalk 

by Michael Pierce 

Programming with AppleTalk is the hands-on guide to understanding 
and working with AppleTalk - Topics include: How to create applications 
and system extensions that run with AppleTalk. AppleTalk protocols and 
the protocol stack, transport media, Preferred AppleTalk Inteface, and 
the storage management. Numerous working code examples walk you 
through using RDEV, iNfT, NBP, ATP, and ADSP 
List Price $24.95 Our Price $22.45 (BPROAT) 
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Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devclepot.com 



Learn C on The 
Macintosh 
Second Edition 

By Dave Mark 

New revised edition! 
Easy-to-understand - 
everything you need to 
start programming. Updated and enhanced 
exercises that lead you step by step. You'ii 
learn function, variables, point datatypes, 
data structures, file input and output and 
more! Includes CD-ROM with Metrowerks 
CodeWarrior™ Lite. 

List Price $34.95 Our Price $31.45 
(BLEARNC2} 

SEE RELATED CATEGORY: Dev, Environments 


Learn G++ on the 
Macintosh 

by Dave Mark 

Basic syntax of C-n- and object 
programming. Learn how to write, 
edit, and compile your first C++ 
programs. Features key C-n- 
concepts such as derived classes, 
operator overloading, iostream 
functions and more. Includes a 
special version of Symantec C-I-+ for 
Macintosh. Book/disk package with 3.5" 
BOOK Macintosh disk. 400 pages. 

List Price $38.95 Our Price $35.05 
(BLRNCPP) 

SEE RELATED CATEGORY: Dev, Environments 


m 


C++ 

Programming 
with MacApp 

by David Wilson, 

Larry Rosenstein 
& Dan Shafer 

Learn the secrets to 
unlocking the power of MacApp®, Apple's 
deveiopmeiit environment for C+-I-, Learn to 
design complex windows and views using 
the ViewEdit tool. Lean to support multipage 
text and graphics with only five lines of code. 

List Price $34,95 Our Price $31.46 

(BCPPMAOAP) 

SEF Rfl ATED CATEGORY: Tools, Libs & Utilltifis 


Object 
Oriented 
Program 
Design 

by Mark Mutlin 

A concise guide to the 
concepts and 
techniques of OOP 
design. Clarifies the key concepts of object 
oriented programming such as objects, classes, 
entities, hierarchies, and inheritance. Uses 
typical database application to illustrate each 
OOP topic, to give a familiar point of reference. 

List Price $22,95 Our Price $ 20.66 
(BOOPRODES) 





PraQramming 

Primer Atruui 

Macintosli 



Macintosh C Programming Primer 
Volume I 

Second Edition, Inside the Toolbox Using THINK C 
by Dave Mark and Cartwright Reed 

Updated new edition of the Macintosh programming best 
seller. System 7, new versions of THINK C and ResEdil. 
Learn how to use the resources, Macintosh Toolbox and 
interface to create stand-alone applications, 672 pages. 

List Price $26.95 Our Price $24.25 (BCPRIMI) 


Macintosh C Programming Primer Volume II 

Mastering the Toolbox Using THINK C 
by Dave Mark 

Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, and 
the Memory Manager, 528 pages. 

List Price $26.95 Our Price $24.25 (BCPRIM2) 


Perl Quick Reference 

by Michael 0. Foghiu 
Commands are sorted by task, class packet, 
platform or hardware compatability all in 
alphabetical order. Includes jump tables to 
guide reader to specific pages in the 
reference. Designed in a larger trim size than 
traditional Quick References-and with a lay- 
flat binding, 

List Price $19.99 Our Price $17.99 

(BPERLREF) 

OBJECTIVE-C 
Object- 
Oriented 
Programming 
Techniques 



by Lewis J. Pinson and Richard S, Wiener 
Presents the basic concepts of object- 
oriented design and programming, and 
provides a precise description of the 
Ohjective-C language. Several small- to 
medium-sized applications using Objectlve- 
C illustrate the general principles of object- 
oriented programming. Covers the two main 
versions of the Objective-C language. 
Demonstrates the versatility and power of 
the NeXT machine as a platform to support 
object- oriented programming. Shows how 
to design, implement, and use hierarchies 
of classes. Explains the purpose of pre¬ 
defined classes and shows how they can 
be used in designing programs. 

List Price $37.95 Our Price $34.15 
{BOBJCOOPTl 





MacsBug Reference & 
Debugging Guide 

For MacsBug version 6.2 
by Apple Computer, Inc. 

MacsBug is an assembly-language- 
level debugging tool. Includes 
macros, templates, dcmds, and 
other resources for making debugging 
easier. Covers how to display and set 
memory and process registers, disassemble 
memory, and set execution breakpoints. 
Explains Discipline, a tool for testing the 
validity of toolbox parameters, and 
debugging strategies to find & cure common 
bugs. Includes MacsBug 6.2. 

List Price $34.95 Our Price $31.46 
(BBUGREF) 
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Mastering the THINK 
Class Library 

by Richard Parker 
Provides a thorough examination of 
Symantec's extensive Class Library and 
the Visual Architect. A complete 
description of the structure and 
operation of the TCL includes 
explanations of all code generated by the 
Visual Architect, any necessary custom code, and the operation of 
this code. Visual Architect tutorials provide you with a step-by-step 
approach for simplifying the development o! complex Macintosh 
applications, 496 pages. 

List Price $29.95 Our Price $26.95 (BMASTERTCL) 

SEE RELATED CATEGORY: Dev. Environments 


Visual Programming with Prograph CPX 

by Scott B. Steinman and Kevin G. Carver 

An introduction to the language and a guide for advanced users, 
for both Macintosh and Windows-based machines. 

List Price $34 Our Price $30.60 (BVISPRO) 

SEE RELATED CATEGORY: Dev, Environments 

The Power of Prograph CPX 

by Dan Shafer 

Master ihe revolutionary graphical object- 
oriented programming language. Step-by-step 
course through three interrelated projects of 
increasing complexity. Learn Prograph 
language, CPX classes and object editors. 
Includes disk with all code in the book. 

List Price $49.95 Our Price $19.95 
(BOANPRO) 

Inside CodeWarrior 11 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is tie printed 
version of the documentatran provided on the CD, Covers 
CodeWarrior, the debugger and associated tools. 

Our Price $34.95 (BINSCW) 

SEE RELATED CATEGORY: Dev, Environment 


Metrowerks CodeWarrior Programming 

by Dan Parks Sydow 

Includes CodeWarrior Lite, and Full Coverage of PowerPtanf''^, 
The best information on Metrowerks CodeWarrior, giving full 
coverage to the Gold Edition. CD Includes Code Warrior Lite. 

List Price $39.95 Our Price $35.95 (BCWPROG) 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


C++ Programming with 
CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles, Learn 
object-oriented programming techniques 
using C-n- as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

List Price $35.95 Our Price $32.35 (BCPPCW) 

CodeWarrior Software Development 
Using PowerPlant 

by Jan L. Harrington 

C-(-h programmers will learn to develop object-oriented software 
applications tor the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite, 

L ist Price $34,95 Our Price $31.45 (BCWSWDEV) 


Inside PowerPlant Manual 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor, Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 

Our Price $34.95 (BtNSPP) 

SEE RELATED CATEGORY; Dev. Environment 


Macintosh Pascal 
Programming Primer 
Volume I 

Inside the Toolbox Using THINK Pascal 
by Dave Mark and Cartwright Reed 

This tutorial shows programmers new to 
the Macintosh how to use the Toolbox 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec's THINK Pascal, 544 pages, 

List Price $26.95 Our Price $24.25 (BPASCPRI) 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing scripts or to write 
new ones. Contains usefui information for programmers who are working on scriptabie 
applications or compiex scripts. Features detaiied definitions of AppleScript terminology 
and syntax in the following categories; Value classes, commands, objects and 
references to objects, expressions, controi statements, handiers, and script objects, 
inciudes many sampie scripts, discusses advanced topics such as writing command 
handiers lor soript applications, the scope of script variables and properties declared at 
different levels in a script, and Inheritance and delegation among script objects. 

List Price $29.95 Our Price $26.95 (BALG) 

SEE RELATED CATEGORY: Scripting 


Order Toll-free 
800-MACDEV-1 

(0OW22-33811 

AppleScript Applications: 
Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O’Hara 
Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac-Like". Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan, 

List Price $34,95 Our Price $31 (BAPSCAP) 


Applied Mac Scripting 

by Tom Trinko 

Learn to design and develop powerful scripts, 
Covers AppleScripr^, Frontier, QuicKeys, 
Tempo II, nShell, FaceSpan Application 
Builder, Scripting PlainTalk and System 7.5. 
Hands on tutorial shows you how to automate 
your Macintosh activities by learning how to 
use the AppleScript and Frontier scripting 
environments. Harness the capabilities of a 
wide variety of Macintosh applications into 
the integrated productivity tools. This includes 
such things as Die newspaper script which 
combines the power ot SITcomm, MacWrite 
Pro, and FileMaker Pro, or QuarkXPress. 

List Price $34.95 Our Price $31.45 

(BAPPLIED) 

SEE RELATED CATEGORY: Scripting 


AppleScript Finder Guide, 
English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes 
and commands. Write, record, or run scripts 
that trigger the same desktop actions that 
you trigger using the keyboard and mouse. 
List Price $13.95 Our Price $17.95 

(BAFG) 

SEE RELATED CATEGORY: Scripting 


AppleScript Scripting 
Additions Guide 

by Apple Computer, Inc. 

Use the standard scripting additions 
commands. Write scripting additions. 

List Price $18.95 Our Price $17.05 
(BSCRADO) 

SEE RELATED CATEGORY: Scripting 
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The Elements of E-Mail Style 

by Brent Heslop and David Angell 

Write solid, effective E-Mail and avoid common pitfalls. 
List Price $14,95 Our Price $13.45 (BEMAIL) 
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Web Page Scripting Techniques 

by MacMillan 

Manipulating color effectively. Placing images and using 
shapes. Using JavaScript functions and objects, plus 
VBScript functions and objects. Determining users browser 
type and operating system, 

List Price $50 Our Price $45 (BWEBPST) 
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Netscape Navigator 3.0 

by Bryan Pfaffenberger 

Learn the best Web surfing 
techniques. Quickly find your way to 
valuable information on the Web. 

Learn to use the new plug-in tools, 
including Live3D and Real Audio. Send 
and receive electronic mail to anyone 
on the Internet, Utilize the enhanced 
security features for on-line shopping 
and ordering. 

List Price $29.95 Our Price $26.96 {BNETN3) 



Check out our Web site! 


• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



Internet Publishing with 

Adobe Acrobat by MacMillan 

Optimizing PDF for Web viewing, integrating 
MTML and PDF, selecting PDF page 
dimensions. PDF file evaluation. Setting 
links to PDFs and URLs, PDF forms, 

Security algorithms. Configuring Web 
servers for PDF. Embedded PDFs, PDF 
creation techniques. 


List Price $40 Our Price $36 (BIPWAA) 


Netscape 
Navigator 
Starter Kit 




Netscape Navigator 
Starter Kit for Macintosh 

by MacMillan 

Create your own home page in minutes 
and add hyperlinks to your favorite web 
sit&s. Add graphics, audio, and video. 
Download files via FT?. Load plug-ins to 
enable movies, audio, animations, and 
more. 


List Price $34,99 Our Price $31.49 (BNETNSK) 


Providing Internet Services 
via the MacOS 

by Carl Steadman and Jason Snell 

Shows you how to provide Web pages, RP. Gopher, e-mail, and more 
with the Mac OS. Includes CD-ROM containing all the Mac server 
software and utilities you need. 

List Price $34.95 Our Price $31.46 (BPROVNFT) 




Building and Maintaining 
an Intranet with the 
Macintosh 

by Tobin Anthony 

Set up services such as video conferencing, 
Real Audio, message boards, employee 
scheduling, e-mail, WWW, ftp. and many 
more. Find a simple, cost-effective solution to providing corporate 
information to company employees. Learn how to open portions of 
your intranet site up to the internet while keeping private information 
safe. Companion CD-ROM. 

List Price $50 Our Price $45 (8BAMAI) 
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Cyberdog 
Programmers Kit 

by Apple Computer, Inc. 

Apple's official reference. A must ^ 
for developers who want to make ''•So’ 
customizable Internet access available to 
all Mac users. Included CD-ROM contains 
ail the tools needed to create Cyberdog- 
'- ' aware components. 

List Price $39.95 Our Price $34.95 {BCYBERDOG) 
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Planning and 
Managing Websites 

by Jon Weiderspan and Chuck Shotton 



The definitive guide to setting up and running a Web site on the Macintosh. Learn 
everything you need to know aboul using WebSTAR, the best known FITTP server 
software and its shareware predecessor MacFITTP. Write CGI applications for your 
server - in AppleScript and in C. CD includes a special version of WebSTAR, plus tons 
of useful software 

List Price $39.95 Our Price 35.96 (BPIANWEB) 
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List Price $14,95 Our 


Java in a Nutshell 

by David Flanagan 

A complete quick reference guide to Java, 
the hot new programming language from 
SunMicrosystems, Contains descriptions of all 
of the classes in the Java 1.0 API, with a 
definitive listing of ail methods and variables. 
Also contains an accelerated introduction to 
Java for C and C++ programmers who want 
to learn the language fast. 

Price $13.45 (BJAVAMUTl 



JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 
Allows non-programmers to take advantage 
of the power of Netscape Navigator. Expand 
the capabilities of your Web page, without 
having to understand C or C++. CD-ROM 
contains "Wiziets" that allows you to easily 
create your own JavaScripts. Takes you step- 
by-step through programming cross-platform JavaScripts. Details 
how to create JavaScripts for JavaScript-aware Web browsers. 

List Price $45 Our Price $40.50 pjAVASCRPTJ) 


JavaScript 





Hooked on Java 

by Arthur Van Koff, Sami Shaio 
and Orca Starbuck 

Written by the Java development team at Sun 
Microsystems, Inc. An introduction to using 
applets, tor Web administrators, designers, 
and developers. Demonstrates how to use 
applets in your own pages. Includes a concise 
introduction to the Java language, and a CD with tools. 

List Price $29.95 Our Price $26.95 (BHJAVA) 

Java Language API SuperBIble 

by Daniel Groner, Todd Sundtsed, Casey Hopson 
and Harish Prabandham 



BwBippNEl Learn Java 
on the Mac 

by Barry Boone with Dave Mark 
Easy-to-follow Introduction for beginning 
programmers and Webmasters, Takes you 
through the core concepts of Java. Includes; 
Object-oriented techniques, unique features 
such as garbage collection, and basic 
programming concepts such as working with variables, threads and 
classes. Learn to apply this knowledge to write original Java applets 
for Web pages. Includes CD-ROM. 

List Price $34.95 Our Price $31.45 (Bljava) 
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Covers Java 1,1. Provides liundreds of concrete source code 
examples. Sample projects introduced & assembled in each chapter. 

List Price $59.99 Our Price $53.99 (BJIAS) 


Intranet Web Development: 

Enterprise Alternatives to Client/Server Computing 
by Hayden Development Team 

Learn why traditional client/server computing is being replaced by 
new WWW technologies. Discusses WWW application development 
with the Microsoft Visual Script enterprise application developer in 
mind. Learn techniques for the conversion of existing Visual Basic, 
C++ and PowerBuilder Applications to the new VWW platform. 

List Price $49.93 Our Price $45 (BINIWD) 



Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes 
CD-ROM with a limited version of Roaster, the first commercial, 
integrated applet development environment tor Java for the 
Macintosh! 

List Price $40 Our Price $36 (R)AVAMAC) 



PRODUCT 

CODE 

LIST PRICE 

OUR PRICE 

CGI By Example 

SSGIBE 

34,99 

31.45 

NetObject Fusion Handbook 

BNETOFH 

50.00 

45.00 

Learn HTML on the Mac 

BLKTML 

29.95 

26.95 

Mastering Netscape 2.0 for Mac, 2nd Ed. 

SMASNEr4 

40.00 

36.00 

Infini-D Revealed 

SINFDREV 

45.00 

40.50 

DeBabelizer: The Authorized Edition 

BDEBTAE 

45.00 

40.50 

Sex, Lies and Video Games 

BSEX 

34.95 

31.46 


28 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 























3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 30 graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

List Price $39.95 Our Price $35.96 (B3DGRAP} 






3D Graphics-Tips, 

IHcks, & Techniques 

by David Kalwick 

Written from a user’s point-of-view, this 
book covers all the important 3D 
techniques including lighting, 
textures, animation, camera 
angles, and perspectives. 

Through easy-to-understand 

examples you'll learn how to create high-quality 3D grapiiics. 
Includes a Windows/Mactntosh CD-ROM featuring tutorials, 3D 
examples from the book, and more. 


List Price 34.95 Our Price $ 31.46 (B3DGTTT} 


Graphic Gems V 

Edited by Alan W. Paetti 

Loaded with practical tools tor 
implementing new ideas and 
techniques, to offer working 
solutions to real programming 
problems. Contains over 40 new 
gems in ellipses, splines, Bezier 
curves, and ray tracing - 
displaying the most recent and 
innovative techniques in graphics 
programming. Includes a disk with 
source code from all five volumes. Available in both IBM and 
Macintosh versions. CONTENTS: Algebra and Arithmetic 
Computational Geometry, Modeling and Transformation, Curves and 
Surfaces, Ray Tracing and Radiosily, Halftoning, Image Processing, 
and Utilities. 

List Price $49.95 Our Price $ 44.95 (BGEMS5) 




Web site: http://www.devdepot.com • 


Tricks of The Mac Game 
Programming Gurus 

by McCornack, Ragnemalm, Celestin, et al. 

For beginning to expert game 
programmers. Complete overview of all tie 
necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code, 
CodeWarrior''’'^ Lite and game demos. 
QuickDraw 3D and Power Mac optimization and inside info on how 
Clypha III was created, Hundreds of tried-and-true tricks, tips, and 
insider secrets from well-known Mac game programming experts, 

List Price $50 Qur Price $45 (BThicks) 





Black Alt of Macintosh 
Game Programming 

by Kevin Tieskoetter 

Develop your own 30 games in 
C on ttie Mac. Includes CD with 
project files (or both Symantec 
C and Code Warrior, Create 
freeform texture-mapped games and 
polygon graphics, Conto! dynamic source 
code ■ all compatible as native to the Power Mac. Write directly to 
tie screen, bypassing QuickDraw. 


List Price $39,99 Our price $35.99 (BBLACK) 


Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software’s color capabilities 
with step-by-slep instructions. Augment 
the color support supplied with 
QuickDraw, and QuickDraw GX, Use the 
Pallette Manager to get ttie best colors on 
limited displays. Match colors between 
screens and input/output devices (scanners & printers). CD includes 
a complete reference information in both QuickView and Acrobat 
formats. Pius, a sample application demonstrating ColotSync 
programming techniques. 

List Price $36.95 Our Price $33.25 (BADVCI) 



Order Toll-free 
800-MACDEV-1 


|8006??338I1 


E-mail: orders@devdepot.com 29 
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^Al^*** 

There's 

\jVlorey 


Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 


PRODUCT 


CODE PRICE PRODUCT 


CODE 


PRICE 


Development Environments 


Applubicripl Applicotlonfi. Buiklmg Apphcouorts w/FnocSjKm - 

..BtfSCAP., . 

$31.46 

C++, for DummiiS. , .. . 

__8CPPDUM .. . 

17.95 

IcH the Proijiiiniiiiuiu MS I3AS1(7 

.... rMWT 

32.30 

C fin Dill III rii[¥iMDl 1 .......... 

...ncoiM... 

_ ,17.95 

Cm Pri>(^armTmio widiiCo(leWa(nor.r........-,...,...,^„ "" ■■■' 

.BGfTCW.... 

...32.35 

Developing Ubjecl Drieftled ikittware lor the Maonlosh ... 

..DDtVOD ... 

28.06 

C/C+4 1 nuirffi 

wippiKl-H 

.29.00 

Essential Opeiktoc. . . 

.BESOD_ 

35.95 

CodcWonnof kisidc PowciPlant _ 

. BJMSPP 

34.95 

Extcndinti the Mac Toolbox . ... 

.. BETMT _ . 

. 22.46 


rinwswnry 

...31,45 

rrwimialMFH^^ Ilf Preir|ifiiriniirtU .,. 

...urOUND.. 

. 35.90 

Dan SiHtef Presa^la the Power of Prcp"^ CPX. ... .. 

FffViNPfin 

... Ifl.Jfc 

Frarpipfil rt Wnm toiaijii'iatifin ... ... ___ 

...BFRAG.. 

35.96 

FOff lUWNliUK User's Guide " ' . 

BFowusen 

34.96 

Guide 10 Macintosh S^lwaiTJ Loc^ .. 

... BLGGALlZ _ 

24.26 

Irisiclc CodcWiirrifif flcwk 

.EtlNSCW 

34.96 

Rriidtr t(] MucinKish Syuliari 7.5. ... . 

Rt>¥S7.5,..... 

. 2260 

Last PflSJil PrtJ^farrmuHS Tdittoir________ 

ra RTTisnT 

...M.96 

Hew In Wilts Maf;1nti05Ti Software.. ...... 

GWmTF 

. 20.05 

L^fti C on the Maciniosli, 2iid bdition_ 

.BlbAHNEj^_ 

,31-45 

Enada Appielaik... 

..BAFIALK... . 

31.45 

Maslerng ttie "nrink □ass Library ___ 

.. .BMASTERTa ...... 

...26.95 

ktsitfc Eho Macintosh Conwni micaaons Tnolbox.,.,.,.... 

BCDMM. 

. 22.45 


fsewpfinn 

...36,95 

1 a.<^WiitHr RRlererKre.... .. 

.fH AGCFIRir.. 

.......17.96 

Ot^liue-C - Objed-Orief^tad PiogranifliiiXj.. 

, ... .. GOflJCDOPT... 

15 

Lfiarn Ctt on tl^ Maentosh......,........^............ 

....BLRNCPP....... 

. 35.QS 

I^esantinfl Maflic Cap....^ ..... 

. . ljf^^tSMAGIC. 

...15.25 

Learn C on die Macintosh. 1 st tdfbon..... 

. BLtAHfCl 

31.45 

RiKilWbfWAp^eGmde 

Ryiti:urt(w; C( 1 Pniyraiiiniiiig ..... 

eFEALWLD 

36.96 

iiarn C on tira Macmtrish 2rnl Editicjn . 

_BLFARNC? ..._ 

31.46 

. . ... BSWIOPP .. 

39.50 

Mur; PnxjratrNTiiiKj lex Dun links:........... . 

BMACmW. 

17,95 


.....STALKJtN]. 

17 55 

MadnEnsH C PTogrummfif Dimmer Vokinw 1. 

...BCPHWl . ..... 

24.2S 

Visisal Hroflrammirtu wilh hiograph , 

tWlSPHO 

. 30.00 

Macintosh C Programmer Pnmer Volume 2 

eCPRW2. 

. 24.2S 

Wireless Rir TtMJ Nowton 

-- . BWIRELESS. 

31.45 

Macmtodi OLE2 Prog Retercuco WotKbuj witti OLficts_ 

,. ,R01F? 

, 40.45 



IWacinIfJSi'l Pasr;n3 Pitiganitimitig Pi icuer Viilijriie 1 ,... 

...DPASCPRl. 

. ,24.25 

Hardware 



Madntu^ Priogramminq Secrets ..... 

....BPSECRtt 

26.76 



MaonltEh Programming lecimiqucs,,.,, ..... 

BPTECH 

^31.95 

m.RnM I'tinrewvOif 

Rmi'iaiyri 

14Jfi 

26 96 


nCAHC 

Mciu Mejc Pruorturiiuiriij TucfmHiiK.'s.. 

. BMOflFTFCU. 

34.50 


FO AFiFRRFf 

IT.Elfi 

Network rioiilioH: DniuBe .... 

.DNtTfB. 

. .,50,96 


BPCiSYS 

31 46 

NeXISlepUeveiopiTtent lodsS lectimaues-.. 

._ -DNtxrun. 

. 2705 

PowerPC SysRjru ArtlirtOLlijfo 

ETPPCABGH 

31.45 

NcXTSlep Development Tools S Tochmtps.. 

.. BfemjTT. 

..„.27.85 




fJS:XTSliq> fiifriesTil Rtrfraraiuu. 

.DWXTGR. 

. 40.45 

Internet Related 



Prngmnniiintj kiEefTfiCM SiiiTiinfiay. 

.RITifTPK.. 

. 27.05 



NcXISEjcp User Inteffacs GLHjetines 

EINEXIUIG . 

22,45 

1904 NcrnetWIifllo Pocius ... _ 

. -.I594WHITF . 

26 95 


tafcffu^TDni «n 

40 4fi 

Adwi! Jnvtt ....... .. 

.. RACT.IAVA 

23.36 

ftowlrsi Prc)grfijTiiTiirig Giiitio ,, , . -- 

Olift.'Ll Oridrili.’iiPrcxjrnrrinniitj DgiiHju 

ontW 1 rlsjR.?. 

_ ROOPmOFS . , 

.!.. 20.66 

Amenca Ontine lor Dunimies.... 

..GAGLOUW. 

....17.95 

r^l HtdETEBTlfVl Df -P’lHW IlI- 

nrip^pppi^ 

,„.„.35 9fi 

CGI By tEimpfci. . .. . . 

.. .. ... eCGIBt _ 

31 45 

HfR3PrT|f)t t Ketof 

HPSlANftFF 

CoTTfiutor PtTViicy IliiRttxxik ,. 

. GPRIV. 

2Z4S 

.....29,66 

Pnwcrlxidit: Digital Namari's Guide . . 

BPBTDWS. 

22.46 



T-MaK r^HiilialN .,.. 

. RTMAUr . 

.. Z2.45 

PiiwnrPC Prnr^iiiimijr's Timlkil . . 

. _ _RfPOPT... 

. 4050 




Bensnls al E-M Slyki.... 

. JJEMAJL . 

. E 3.45 


nTAUit V 

22.46 

Hookod 0(1 Jawit . . 

BHJAVA 

26.96 

Pro[)^Bm^lling liilindiietkiii ic the MaoiiTinsti Fsiiiily_ 

FYoijfBinmino tor System 7 ... . _ 

- . . JjT AlVliLf . . .. 

liSYS7. 

24.25 



13.45 

IisUimE bilcumil: Giiiric.. . 

RlWaTAfVT 

Programmifig Pnnief MnciiUosti Wiluuia i 

BPfllMMAC. 

. .RPROODRAW. 

34.15 
. .2425 

SniE-xrMil Ffeiiik . ... 

.. rjlillNlT. 

22,50 

hlcfffljt li?l tlhiiruiiicE TnrI tdiliwii .... ........... 

...BNt:rtxjM7.. 

. 17.99 

PffiOiiiiniiiirtij OmMkiiw 

Pi^iyiFiniiHing StHiler Kil... 

1 lifitl'h Ani'^itib Ifilli 

.DPROSTAm. 

RHHnAT 

. .4050 

22.45 

hili^Jiiet 1ai OiJiTimies OwdiRL^erence... ^ 

_. _.fl£XJMUCK. 

a-05 

hiiernof Im Macs Irx Dimuiiics 

0NEE01.JM 

17.95 

P ilrLff^lllllilCI iiVItll r4fj|nti lillR— _ , .. 

(JuIckTime - OltiaaJ tkudc for Macmlosn Users, 

BOTGynE 

45.00 

hilwriul Icji Me'u.'m I[m niinnuifw rtfiiRiii,.. 

....jTMi'nor.... 

35,99 

OnIdtTime Stuprti? KU for ITh! MiKiinitEdi_ _ 

..nnisKfr... 

.. 40,50 




Inlcmel Poi^ Toots..... .. .. 

__ ..ffi’WTTrOOL . .. 

. S6.ua 

neat Wtjikl A(]|Jb Guile ... 

.....brealwld. 

. 35.95 




miernot \*i ii itisHniui wllii Adobrj Acrotial . 

_ tMArtfAA., , 

3G.CE0 

ResEdll All Night Diiiuf___ _ 

.HHESUINfc.. . 

.. 2245 

hiltriiii Smirtii _ 

.BSFCflfT 

36.99 

IfcsEdlt Complctci. Tst Editkiri - _ - 

BREStDl 

. 31.45 

InlHnal, rtw DhIimi TiIiImi . .... 

.IMtDI'llJX, 

31.50 

Ri^Fdlt Cixiipilule, ?ii(i RlilitNi., 

FkffiEdIt Reference... .. . 

. _ ..BRFSFD2. 

..BRESEDREJ-. 

. 3146 

. 26 96 

Iulranof Uwv.. Lnlcrpiisef Mternalwirs to ClNint/iieiwir 

... ..BUJlWLl_ 

4499 



17.95 

Java tssenJials tor C/C ^ ProturadnnwBfs. 

BJAVAESStAl 

Jkiltwara Ijy UeSflflrt. CtnaliFig User Frieixily Suttwrue. 

. _.....EDt^N.... 

26.95 

.iFtVn ■! ti HlRfitHjB _ 

RlAVAflJt. 

13.45 

SyoianlDC C++ tor tfic MaunEosh The Basics 

BSCFTMTH. 

. 31 46 

.Mia hmgisEyij API ....... 



. ....JULAS.^. 

53.99 

TtKiiii 1ftKir;si?ll MnanlnshC-i 1 11121 riEiys... „ - 

RCPP^ID.,.. 

.. 26.99 




JiivaScriol foi Mticinlaslii.. ... 

..... BJAVASCraM.. 

...,40.50 

TRirhnirfll IrtlrnkicEiiio En lEw MniJriU'ish r.-invHy . 

rttumf . ,. 

. 24 26 

Lufltn HTML Lrti Ihc Miicintosli. 

. aHTMl . 

26.95 

Tog orE Software Dosigiii. . 

. . .. .bigg. 

,. 26.95 

1 t^irii lKiki (911 llie __ 

. . BI.IAVA _ 

31.46 

yYirctosslor Iho Ncwlon Qowrinimiorit 1ui Miihil Coiniii 

Wriliixj UXjik/nlJto Rollwiini. . 

ttWIRFI FSR. 

_ _niDCAl. 

31.45 
. 24.25 

Masteeiny Nfjtscape 4.Cl In Macwilosli, Sarrmrl ftliliffli.. 

...8MASNtr4... 

. 3600 

More Inteniel tnrUuiiimKS RJairlef kul... 

, ..iSUUMNbl. 

.... 17.95 




Mosaw: In OosTmiics, .... 

BMnsPUM 

17.99 

Miscellaneotis 



MNlClicil ,,,,,,,, .... 

^ nNETCIlAT 

17.00 




RNFU1R4I 

4500 

Ailnliti Piemip.re Im Ifie MiiciiiTiwIt.. . .... . 

.II*R£M. 

. 44.95 


KNF1NAU 

269.5 

America Online tw D^immies.... — ., .. 

..-_ ..BADLtXJM. 

17a5 


Djupi kll^ 

31.49 

. 17,93 

Art of HiinEart iiitertace Ltesitin___- 

. _.JIAMIO. 

. 29.65 

Ni^y^yjiikN Kit. . 

.. — ... . Wlr:I 

npTRs Rrr 

CD ROM Guido to Mtotirnijtlia Aiiltxjfinij . 

BCDMLI n. 

...-.4045 

mnniiinn suH (UsiiiruiiEiri otpc 

nfl AklUlFlT 

. 31536 

C£uii|Htfi(Kiw5 lu ntiiiimii^:.. .. . - - 

- . nesnuM... 

.. 17.95 

1 iu«llBp^ dllU lYiaptu^iiiy :biLt>£P.. if.. 

Priihilfliiig |iirpii|pt 


31 46 

CrcalinQ Inteiactive CD-ROM.... 

. - ..DIMTEHCDH..,... 

.. 35.95 

Pfttilitd] il TV1 flui UVr4^ 

FM/TiVIIR 

31 46 
99.00 

[jyticrpijiik HfinUhook 

Hcmiw. 

6.95 


PTPPipRWl* 

flairiny Gixxlninn's Miii.tii1tii:Ji H-mikioiik -__ ... 

. .. BGonniifl.. 

........26.95 

._ 

rE^arli in ?l • 

RIAVAlUAf' 

36 00 

fiWiwIiliTlierHMEiikjKijjldR_...._.... .... .......... 

..QEWDnU).. 

. 9.96 

lUtLII IIL7Lfl^5lll> dtlTd lEi 4- 1 Ullf ujj ■.■ ■ MdJ.|[|.| ■ | u ■ | ci m 

ILvh^friijujnel IilJi^J iikuiiidtlihii 

i.timiii11 i. 1 iI.I■ ■.■.■.■ 1._..pLr^hiiTUVriiLp______ 

22.4!i 

PramfA^rks Sffljjire Code Disk..., - . 

.---MfMW5C„ . 

.. 9.96 

kATr^L i-lrL-‘ifl U-H- 

- . ixwiucn ... 

RUiFRhFAII 

22.45 

PranieWbiks Masa^iiie Back lissue. ... 

.MTFWBACK 

. o.tw 

TftaJ-nLall,l jVidi. llrtRlIU —. — 

Wpti ^^iplliuj 1jJ4"hiiii|iip< 

liwrlTPSi 

45,00 

GkJha] fntcrfjcc DcsttFi 

.BGIDflAt 

32,35 

WnTi Wnnuinn 

irwwfAv 

..22.45 

Grn|drkE{lHiiLs2 .... 

.-..DfirMS?. . 

,.^...44,95 


FiFi (.Ml"!"...uiTTrLyi'T.... 

HWl-BAlASl 

26.96 

CrapbicGetiK 4... .. ... 

..JGEMS4__ 

. 44,35 




Graphic fiiins V . 


_ 44,96 

Scripting and Solutions 



Iiihiii ORuvisifLiil_ _ ._ _ ___ 

.. . 

R*IFnRFV . 

40.S0 



Lalp Nkjht witli Mnullni'k 

in ATT 

26.35 

AppieSrrfipt Ap^toliofis: BtRlbrnfj App® wiTh PaceSipaiT. . 


. 31.46 

Mac liaEfTTOtxn Iteador... ... 

!.1....liSAIH.- - 

.^-41,70 




AppliedMacjntosti Scnpitwig... . 

. RAPPitin 

. 31.45 

Mac Soresmer Hie Ulamaie Maciniosts SuperfrtaiQing Kit. - 

Meantosh Crash Course.. .. .. 

. . JSCJtAM_ 

Hmflj3ti 

,31.50 

2E.95 

Cixmilt'Jfc A)]fik!SiT|H ItJiiMixuik_ ___ _ 

__RAPE sera-iR . 

31.50 

Cotr^iltle HyjieiCartI 22 HarirJlxiok...... 

........BHYPenoa ... 

,...-31.50 

Miiclect! DiitJi iHhURs. .. 

MTTWtKlS.B 

10.00 




Danav Goodman’s Guide Starter Wl... 

___BOC ACM.... 

...31.46 

1 IlirltdlEh PiJl^lrtb'HC!lT Q/v^Ll 

fll 1 TMACT 

^r, !^] 

HpjrCam Stock Design 

..eHYPSTA 

19.9.5 

muLVnJflLl LNIJUIalB IVuLIIIILkml .. 

MQnRQHng'AppIsSirare & WtxkgroiiE) bsTvers 

.. BMAWS 

_2G.96 

llvfjtjiTalk 7.7: TTifj flffljk . ___ _____ 

. ... ...GIlYFTAl __ 

31.50 

MATJACON *93 00 ROM..... 

...SMADA93.-.- 

9,96 

JavaiScrIpE te Macintosh......... 

.....aiAVAScnpT. 

. 40.50 


m Al J iLh rPi_i 


Herl LkflCk Hetererx^.... . . ... .. 

.. .... .... ..BPtHLHtl-... 

...17.99 

MidliiriHiliii AnlfxRiiiij': fkiildiiiLj iintl Duvelniiirig DM:iitiieiiEs.....M....^. 

MiriMmarfis kll \f\r U^intiviTh 

._IlMmAUTrl 

R14M.^TtArtl 

.,„... 27.00 

Real WorR! Apple Gixdc__ „ .. . .. 

..GREAimO. 

.35.95 

liwyliH trrw'Y^ UvrVaHdvWria 

ufiwinT 

22.45 

Technical Relerence 



rn;||]T ....-.I, 

Sad Macs Bombs and Disaslors .. 

.. BSADMAC. . 

22.45 



Sill]wl Mite Tfichi; . . 

- .RST11PIDMAC. 

. 17.95 

Aciwe Java... ..... 

_ _....BACf JAVA ... .. 

23,36 

Tlk; Snllvvrcre Pnvdr^jet's & Marketnl'S Legpl Cwi'ipiniioci.. 

.. ...H, ., .BSOAMLC, 

.... ...33,26 

A^jfiki 0) ROM llnrxIiHxik. ... . ... 

__ ..ncntiAND. 

14.30 

fil Mu (ijin'w 


45,00 

AiltiT HuniHii InlHifaO) Dosiqii...... 

.. ....BAHID. 

2965 

11 KiiTu in U V rndL U4]l ifO UKil Eld . .. • . 

7nii and fi^ Ad of Rr?yi| irrrf pddi^g 

. ...... 

RPAAORF 

27,00 

BfacK ArE of Mac Game I’nograinnmig .. ... 

.,™.._. .. 

. 36.99 





30 1-800-MACDEV-l • Outside U.S. & Canada: 805-494-9797 • Fax; 805-494-9798 








































































































































































































































































































































































































All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh (game section)..... 

3D Graplws Programming Using QuickDrm 3D ...... 29 

SDGrapiifcs- fips, Tricks, S Techniques ........ 29 


A. D. ^ttwarc. 

A FragrrmtofYourfmogination....... 

A Zillion Sounds (game sectton)» 


...11 
,..23 

...19 

Abaoft Corporation...............9 

.10 

29 
26 

...A 
.22 
.26 
.26 


......3,4, 12.21 


Adianta Inc...... 

AcPancecf Coior irrjag/ng on Uto Mac OS... 

Apple Dxnpuler. Inc.. 

Apple Dylan Technology Release 
Apple Guide Integration 

Apple Media Tool Programming Environment ZO.. 

Apq/eCuicfe Complete .............. 

App/eScfipt AppTcations: BMing App/fcations with FaceSpan. 

AppioSchpt Finder GaidP, rng/ish Diaiecl...,. .*... 

AppicScffpt Finder Gude. Ehgfish Da/ect. ....... t2 

AiCpfcScnpf Language Guide.. ......... 26 

AppieScript Schpting AMtions Gt/ide. ....... 26 

AppleScript Software Development Toolkit 1.1__ _J 

AppHed Mac Scriptirkj . 


...26 


AppMaker---- 

Arboretum Syslenis. 


....6 

AudinTrack._.... 


..........._ fi 


B 

B-Tree HELPER 

Bam Bones Sdtwom... 

BAS/C fcr the Newton,,..,,,,. 


_* __ 

.11. 15 

... 23 

RRFriitin 


11 



....19-20 

... 

Bee-one .. .. 


......18 

Ses^ of MacTulor..., ...... 

F^ack Aft of Macintosh Gtime f^morammina . 

...2 

... .29 

Bowers DtsweloorTierit 


..„„16 

Building and Maintaining an intranet with the Mac . 


_C_ 


Ck Program/T7;f7g w/ifltf? Ooctel/Vfei/T^.......25 

Cn Programming with MacApp ...... ..24 

c-lree Plus® Database Handler...........13 

Gapilano Gompi if ing... .......17 

Captivate 4.6: Essential Graphics Utilities...... 3 

Casinot (game section),.................19 

CGi Toolkit____________.17 

CGf TodM ByExampie......... ....... .28 

Classic Arcade (game 19 

Clip VR™....... 

CodeManager. 7 

Code Warrior for BeOS DR2...........7 

CodeWarrior Gold 11 ....—.....™.7 

Code Warrior Wear_ _.7 

Compilett!._... ......14 

Conix Graphics............ .17 

CPU Doubler... 13 

CronManager_____13 

CWSo^fiware TOeve^opmani U^ig Pum^PLnL.... ...25 

Cytet^og Pro^amnt^s K/l.................27 


Danny Gexx^man^s Apple Guide Str^ter Kit .... 22 

DeBab^r: The Edkion ..... 2B 

DesignWorks 4.0*................17 

Development Environments, additional products......10 

Digital Technology Intemafonal........,.,T2 

cttF Americas............15, 17 




.22 


e\fex Pmdjuctians,. 
Exed Software.. 


....5 

..14 


F77 SDK.. 

FaceSpan v2.1..,.. 

Faircom.... 


horlner Research LLC. 

Future Basic II 


....J9 

„.12 

...13 

....8 

.15 


Goldilocks Gamebook (game section). 

GropNc Gems i/........ 

GLiarantoe Terms.. 

Guide Composer!^” 1.2.. 


.....1 

..*13 



H 

■ 

i , 

Hooked on Java . 


... .28 

h i 


Hyperprism-68K Real-Time Sound Effects Processing.*, 
Hyperprism-MMP Real-Time Sound Effects Processing, 
Hyperprism-PPG ReaPTlme Sound Effects Processing,.. 
Hyperprism-TDM Real-Time Sound Effects Processing.. 


,.6 

._6 


inM-D Pcvcaibd..*..... 

inside CodeWarrior ? J........ 

inskP. Maemtosk AOCF/^icatior^ ini&-face. ... 

in^de Maciniosit: AOCE ModuP ..... 

/asxfe Macinio^v CD TOW........ 

Maanto^r. DcMces ........... 

/riacte Madnfosfp: T/fes........ 

inside Madnfosri; imaging with Qi^kCkaw . . 

irr^de M&DintoBh: interupplicatlon Communicattns . 

inside Macintosh: Macintosh Tootox Essmtinis . 

inside Macintosh: Memory ...... 

inside Macinto^: More Macintosh TooUxox ... 

inside Macintosh: Networking.. ..... 

Inside Machtash: Operating System UtHities .. 

inside MaeJniosh: Overview .... 

Inside Macintosh: PowerPC Ntjmerics....... .. 

inskJe Macintosh: PowerK System Software... .... 

Inside Macintosh: Processes ........ 

Inside Macintosh: QuickDraw GX Environ, S ................. 

hsde Macintosh: QuickDraw GX Gmphics.... 

inside A4acintosh: QuickDraw GX Objects.. 

tnsido fl4acintosh: QutkDmw GX Printing... 

tnskP Macintosh: OuickDftrw GX Phriting Extenskyj..... 

tnsido Macintosh: QutkDrow GX fir>g. Overview... 

inside Macffitosh: QjickDrmv GX Tyoography... 

Inside fvfacintosh: Okckfime.......... 

Inside MacMash: QutkJkne Comportenis.... 

inskie Macintosh: Sotind.......... 

inside MaUntosh: 7exC............ 

Inside Madnlosh: X-Pe/erence..... 

inside pQwerP^ii Manual.....-..,,... 

iniemei /Vhlishirtg with Adobe Acrobat... 

intranet VMi Dev^opment....... 

Ionizer Real-Time Dynamic Spectral Reshaping Tool*. 


...28 

...25 

...21 

,.,21 

..21 

.21 

...21 

...21 

...21 

...21 

...2i 

...21 

...21 

,.,21 

..21 

...21 

,..21 

...21 

...21 

...21 

...21 

...21 

...21 

..21 

...21 

..21 

...21 

...21 

...21 

„21 

...25 

...27 

...28 


Java in a Nut^ieH. ... 

JfM Language APi SijpenBfiWe.. 
JavaScript for the Madnfosh_ 


..26 

..28 

..28 


Late Nighl SolLwane Ud....... 

Lesarr; C-h- orf tlm Madntosli .... 

team C on ??ie Macintosh Second Edi^., 

Learn HTML on the Mac,.,, ... 

Learn Java on the Mac ...... 

Legtop PcKleum * 


LiveAccess™ 1 Developer Edition..,. 


Web site: htip://www*devdepot,com • E-mail: orders@devdepot,com 


...12 

,..24 

.24 

...28 

..28 

».13 

...17 


31 


t 
t 
t 
t 
f 
t 

b 

h:- 

I 

» f 

I ■ ■ ^ 

t 


I S 

i ^ 

i M 
















































































































































































































LlveAccess™ 1 User Edition..........17 

LS Fortran Plug-(n ....... M 

L$ Fortran Pro.......... 


Pfvgr&nming For 77>e Ateivfon................... ..23 

Rog^twriing with . ....... ...23 

ProvkHog fotefwt Servkm via fho MacOS......... 27 


M 


Mac OS 8 fievealec/,........... 

MacA&D 6.0____ 

MacRow''^: Flowchart Design and Development 

IVtoDtosft C Programming Primer \^Dfume i ... 

Madntosh C Programming Primer Vbfcjme it .. 

Wtoftos/) Pasc^ Pmgmrmmg Pnmer \Mjrm /.. 

Macintosh Pro^amrrmg Socrets.. ... 

MacsBiJg Ftet^scmcB & Dsbuggtrg Gyicfe. ,.,...,,.... 

M^Toch......... 

MacTech CD-ROM Volumes 


.22 

..14 

„16 

.24 

.24 

.25 

..23 

..24 


MacTech Mouse Pad... 

MagreeaWe Soltware.............. 15 

Main Everil Software,...........,.,12 

Mainstay .............. 6 , 9,16 

Mango Tree Softw^..........12 

Mastering Atefscqpe ZO for Macinlosti ....... 28 

Mastering the JHtNK QassLtrmy. ........25 

Memory Mine „ n...... . . ... . . .10 

Me^ro werks......... .......7,25 

Mefrowerics CodeV^nior Programrrmg.. .......25 

Multimedia Authoring with Apple Media Tool T- .unT.o.rrTTTTTTiTt...A 

Multimedia Nursery Rhymes {game section}.19 

MuftiWare Multimedia Music Clips (game section) 9 

Music Tracks {game section) ..........20 


N 


Native PowerPack............................5 

NeoAccess........13 

Nootagic,...........13 

NetObjects Fusion Handbook ....... 28 

Atef,scape Nnvigntor 3,0 ........... .2 7 

Netscape Navigator Starter Kit for Madntosh ....... ....>27 

Network Frontiers Bundle..................23 

Newton Progranvner^s Grjide for Newton 2 0. .. ........ 3 

Newton Toolkit 1.6,.---- 

Nextstep Development Tools and Tedwvr^jes... .... 22 

Nextstep Genera/ Befererice.,............22 

Nextstep Programming interface Summary ........ 22 

Noxtstcp User interlace GuideSnes. .........22 

Night Sky Interactive {game sectior^^_____«..._19 

hiisus Software...............,...T8 

NS BASIC 3.6 for the Newton with Visual Designer.....10 

NS BASIC Corporation......................10 


O 


Object Orienied Rogram Design ........ 24 

Object-Oriented Fundamentals 1.1. 

Objective C - Otjecf-Ohented Programming TechniquQs ... 24 

ObjectSet Mail SDK lor Macintosh.......11 

Onyx lechnology..........14 

OOFILE Reporter Writer...............11 

OpenDoc Fvi^ammef's Cbotoook.... 

QaenDoc Programmer's Guide ...... 22 

OpenGL for the Macintosh------..17 

Optimtzing PowaPC Code: ............ *...23 

Orchard ^ftware...........13 


Pert Quick ffeferenoe........ 24 

Personal MachTen forOSK Macs...........11 

Phyla^**: Object-Oriented Database__ 

Piclorius Inc...........17 

Plan & Track™: Project Planning and Management.^.6 

Planning and Managng VVfetoles...... .....27 

Power of Prograf^ GW..................25 

Power Box..............18 

PowerBuilder Desktop for Mac..*.™._____*____11 

Ftiw^PQ Programmer's Tootkit,.. ..... .23 

Pow^sofl....................11 

Pro Fortran ...._____________J 


0 


QC...........—---—.14 

QUED/M 3.0..............18 

QuickTime Developer'^ Kit 2.0........4 

QuickTime VR 2.0 Authoring Tools Suite....... 


R 


r-tree Report Generator_____________13 

Rach Inc...........,,....,13 

FiesEdit Alt Night Drier........ 22 

ResPdit Complete.. ........ .22 

Roaster____ 

Roasler Technologies, Inc,.........„„8 

Royal Software, Inc,,,.........12.14 


5 


Screen Machine (game section).......20 

Script Debugger---------— .12 

Scripler ZO.......—.12 

ScriptGen Pro....... ...—...--- —*.15 

Scripting, addititmal products______...,12 

Seapine Software, Inc............ 

Sex, Lies and Wcfeo Games...........28 

Smartcode Software..........1 

SoftPolish CD-ROM... ,...15 

Spellswell Plus .....15 

STAZ Software...........15 

Step-Up Installer Pack—.... . ...15 

StepUp Software...........13,15 

StoneTable 68K/PPC.. 14 

StooeTablet Publishing,,,,........14 

Symantec Corporation.......8,11 

Symantec Visual CaM.... .. . .....A, 11 

System 7.5 Technologres.. ..3 


TCP/IP Scripting Addition.......12 

Teach Vborae/f Java for A4acrifosh in 2? Days ....... 28 

Tenon Intersystems............ 12, 18 

TestTrack-Bug Tracking the Macintosh Way.......*«..-.16 

The SsmoTTfs of Sfyte.........,,.-26 

Tog on Software Design........... 23 

Tools Plus libraries + fmmeworfc........^.-----10 

Tricks of The Mac Game ProgramrTvng Gurus .... .....29 

Trivia Warehouse 2000 {game section).......-__ 


U 


UNI SOFTWARE PLUS ... . ......14 

VIP-BASIC™: Visual Interactive Programming in BASIC,....,.9 

VIP-C™: Visual Interactive Programming in C......... 3 

Virtual Reality Programming with QuickTime VR 2.0........4 

Virtual Tutor for QuickTime VR... 

Visual Programming with DnogrH^f CPX ..........25 

VMStar...!..........17 

VOODOO 1 .a______14 


W 


Vteter^ Edge Software............10 

WaveConvert .... . 

VWES...................5 

W^PageScrp^iQ lectifiiQim..... ........ 26 

Web Ware (game section) 

WindowScript... — ... .—^„.12 

Working Software............15 

Xplain Cc^porefrin...........,.,.2 


32 1-800-MACDEV-1 • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 




































































































































































































Unlock the power of 
PowerPC microprocessors. 

Motorola's optimizing CfC++ SOK, PowerPC!Edition for Mac OS, is designed specifically for developers creating applications 
and tools for computer systems running Mac"^ OS, The Motorola compiler works with Metrowerks Code Warrior, Symantec 
Projec^t Manager and Apple Macintosh Programmer's Workshop (MPW®) to offer a poviferful set of development tools within a 
complete development environment. 

The SDK features the Kuck Associates Preprcx:essor (KAP**^) — a powerful code restructuring tool designed to improve 
)>erformance across a broad range of application programs. The Motorola (70+ SDK delivers world-class code optimization 
for any specific PowerPC mkroprocessoi; while ensuring compatibility across the entire PowerPC family of microprocessors. 

To find out how Motorola can help you unlock the power of PowerPC microprocessors, visit our web site at 
hrtp://www.mot,com/PowerP(7 or call us at l“800“34S-8384 or 1-512-891-2229, 


0 and Motordln are mgistfircd trademarks of Motoro^ Inc, O t996 Mouirols, Inc, PowerPC and Ifi* PowerPC logotype are trademarks of International Business Machines Corp, and are used 
under license therefrom. MPW is a registered trademark and Mac end the Mac OS logo afit trademarks of Apple Computer Inc. All other iradernorks belorvg to Ihelr rnapoctrvo owrtcfs. 
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